Class: EntityGrid&lt;TItem, P&gt;

Set Signature

set initialSettings(value): void

Defined in: src/ui/datagrid/datagrid.tsx:1843

Sets the initial persisted settings.

Parameters

value

DataGrid.initialSettings

Returns

void

Inherited from

props

Get Signature

get props(): WidgetProps<P>

Defined in: src/ui/widgets/widget.ts:307

Returns the widget's props/options.

Returns

WidgetProps<P>

Inherited from

DataGrid.props

readOnly

Get Signature

get readOnly(): boolean

Defined in: src/ui/datagrid/datagrid.tsx:1341

Whether the grid is in read-only mode.

Returns

boolean

true if read-only, otherwise false.

Set Signature

set readOnly(value): void

Defined in: src/ui/datagrid/datagrid.tsx:1349

Sets whether the grid is in read-only mode.

Parameters

value

boolean

true to enable read-only mode, false to disable.

Returns

void

Inherited from

DataGrid.readOnly

sleekGrid

Get Signature

get sleekGrid(): ISleekGrid<TItem>

Defined in: src/ui/datagrid/datagrid.tsx:1804

The underlying SleekGrid instance.

Returns

ISleekGrid<TItem>

The current SleekGrid instance.

Set Signature

set sleekGrid(value): void

Defined in: src/ui/datagrid/datagrid.tsx:1809

Sets the underlying SleekGrid instance.

Parameters

value

ISleekGrid<TItem>

SleekGrid instance to set.

Returns

void

Inherited from

DataGrid.sleekGrid

slickGrid

Get Signature

get slickGrid(): ISleekGrid<TItem>

Defined in: src/ui/datagrid/datagrid.tsx:1815

Deprecated

Use sleekGrid or getGrid().

Returns

ISleekGrid<TItem>

The underlying SleekGrid instance.

Inherited from

DataGrid.slickGrid

defaultColumnWidthDelta

Get Signature

get static defaultColumnWidthDelta(): number

Defined in: src/ui/datagrid/datagrid.tsx:103

Default column width delta applied to all grids.

Returns

number

The current column width delta.

Set Signature

set static defaultColumnWidthDelta(value): void

Defined in: src/ui/datagrid/datagrid.tsx:108

Sets the default column width delta applied to all grids.

Parameters

value

number

Delta in pixels added to each column width.

Returns

void

Inherited from

DataGrid.defaultColumnWidthDelta

defaultColumnWidthScale

Get Signature

get static defaultColumnWidthScale(): number

Defined in: src/ui/datagrid/datagrid.tsx:93

Default column width scale applied to all grids.

Returns

number

The current column width scale.

Set Signature

set static defaultColumnWidthScale(value): void

Defined in: src/ui/datagrid/datagrid.tsx:98

Sets the default column width scale applied to all grids.

Parameters

value

number

Scale factor (e.g. 1.1 for 10% wider).

Returns

void

Inherited from

DataGrid.defaultColumnWidthScale

defaultPersistanceStorage

Get Signature

get static defaultPersistanceStorage(): SettingStorage

Defined in: src/ui/datagrid/datagrid.tsx:1849

Deprecated

Use defaultPersistenceStorage — this has a typo.

Returns

The current persistence storage.

Set Signature

set static defaultPersistanceStorage(value): void

Defined in: src/ui/datagrid/datagrid.tsx:1854

Deprecated

Use defaultPersistenceStorage — this has a typo.

Parameters

value

DataGrid.defaultPersistanceStorage

Persistence storage to set.

Returns

void

Inherited from

defaultPersistenceStorage

Get Signature

get static defaultPersistenceStorage(): SettingStorage

Defined in: src/ui/datagrid/datagrid.tsx:83

Default storage used for grid persistence.

Returns

The current persistence storage.

Set Signature

set static defaultPersistenceStorage(value): void

Defined in: src/ui/datagrid/datagrid.tsx:88

Sets the default storage used for grid persistence.

Parameters

value

DataGrid.defaultPersistenceStorage

Persistence storage to use (e.g. localStorage-backed).

Returns

void

Inherited from

defaultRowHeight

Get Signature

get static defaultRowHeight(): number

Defined in: src/ui/datagrid/datagrid.tsx:78

Default row height used when creating grids.

Returns

number

Inherited from

DataGrid.defaultRowHeight

Methods

addBooleanFilter()

protected addBooleanFilter(field, title?, yes?, no?): SelectEditor

Defined in: src/ui/datagrid/datagrid.tsx:1554

Adds a boolean quick filter for the specified field.

Parameters

field

string

Field name.

title?

string

Optional display title.

yes?

string

Optional text for the true option.

no?

string

Optional text for the false option.

Returns

SelectEditor

The created select editor.

Inherited from

DataGrid.addBooleanFilter

addButtonClick()

protected addButtonClick(): void

Defined in: src/ui/datagrid/entitygrid.ts:284

Handles the add button click by opening a new-item dialog.

Returns

void

addCssClass()

protected addCssClass(): void

Defined in: src/ui/widgets/widget.ts:89

Adds the widget's CSS class to its DOM node.

Returns

void

Inherited from

DataGrid.addCssClass

addDateRangeFilter()

protected addDateRangeFilter(field, title?): DateEditor

Defined in: src/ui/datagrid/datagrid.tsx:1512

Adds a date range quick filter for the specified field.

Parameters

field

string

Field name.

title?

string

Optional display title.

Returns

DateEditor

The created date editor.

Inherited from

DataGrid.addDateRangeFilter

addDateTimeRangeFilter()

protected addDateTimeRangeFilter(field, title?): DateTimeEditor<DateTimeEditorOptions>

Defined in: src/ui/datagrid/datagrid.tsx:1532

Adds a date-time range quick filter for the specified field.

Parameters

field

string

Field name.

title?

string

Optional display title.

Returns

DateTimeEditor<DateTimeEditorOptions>

The created date-time editor.

Inherited from

DataGrid.addDateTimeRangeFilter

addFilterSeparator()

protected addFilterSeparator(): void

Defined in: src/ui/datagrid/datagrid.tsx:1476

Adds a separator to the quick filter bar.

Returns

void

Inherited from

DataGrid.addFilterSeparator

addQuickFilter()

protected addQuickFilter<TWidget, P>(opt): TWidget

Defined in: src/ui/datagrid/datagrid.tsx:1502

Adds a quick filter to the quick filter bar.

Type Parameters

TWidget

TWidget extends Widget<any>

P

P

Parameters

opt

QuickFilter<TWidget, P>

Quick filter definition.

Returns

TWidget

The created widget instance.

Inherited from

DataGrid.addQuickFilter

addValidationRule()

Call Signature

addValidationRule(rule, uniqueName?): void

Defined in: src/ui/widgets/widget.ts:142

Adds a validation rule to the widget's DOM node.

Parameters

rule

(input) => string

The validation rule function, or a unique name when the two-argument overload is used.

uniqueName?

string

A unique name for the rule, or the rule function when the two-argument overload is used.

Returns

void

Inherited from

DataGrid.addValidationRule

Call Signature

addValidationRule(uniqueName, rule): void

Defined in: src/ui/widgets/widget.ts:143

Adds a validation rule to the widget's DOM node.

Parameters

uniqueName

string

A unique name for the rule, or the rule function when the two-argument overload is used.

rule

(input) => string

The validation rule function, or a unique name when the two-argument overload is used.

Returns

void

Inherited from

DataGrid.addValidationRule

afterInit()

protected afterInit(): void

Defined in: src/ui/datagrid/datagrid.tsx:219

Hook invoked after the grid is initialized and settings are restored.

Returns

void

Inherited from

DataGrid.afterInit

afterRender()

protected afterRender(callback): void

Defined in: src/ui/widgets/widget.ts:228

Queues a callback to run after the widget's contents are rendered.

Parameters

callback

() => void

The callback to run after rendering.

Returns

void

Inherited from

DataGrid.afterRender

autoRegisteringPlugin()

protected autoRegisteringPlugin(args): void

Defined in: src/ui/datagrid/datagrid.tsx:164

Hook invoked when the grid is registered as an auto-registering plugin.

Parameters

args

AutoRegisterArgs

Auto-registration arguments.

Returns

void

Inherited from

DataGrid.autoRegisteringPlugin

bindToSlickEvents()

protected bindToSlickEvents(): void

Defined in: src/ui/datagrid/datagrid.tsx:697

Subscribes to the underlying grid events.

Returns

void

Inherited from

DataGrid.bindToSlickEvents

bindToViewEvents()

protected bindToViewEvents(): void

Defined in: src/ui/datagrid/datagrid.tsx:777

Subscribes to view events for filtering, submitting, and processing data.

Returns

void

Inherited from

DataGrid.bindToViewEvents

booleanQuickFilter()

protected booleanQuickFilter(field, title?, yes?, no?): QuickFilter<SelectEditor<SelectEditorOptions>, SelectEditorOptions>

Defined in: src/ui/datagrid/datagrid.tsx:1566

Creates a boolean quick filter definition.

Parameters

field

string

Field name.

title?

string

Optional display title.

yes?

string

Optional text for the true option.

no?

string

Optional text for the false option.

Returns

QuickFilter<SelectEditor<SelectEditorOptions>, SelectEditorOptions>

A quick filter definition.

Inherited from

DataGrid.booleanQuickFilter

byId()

protected byId<TElement>(id): Fluent<TElement>

Defined in: src/ui/widgets/widget.ts:154

Finds a child element by its prefix-relative id.

Type Parameters

TElement

TElement extends HTMLElement = HTMLElement

Parameters

id

string

The id relative to the widget's id prefix.

Returns

Fluent<TElement>

A Fluent wrapper for the matching element.

Inherited from

DataGrid.byId

canFilterColumn()

protected canFilterColumn(column): boolean

Defined in: src/ui/datagrid/datagrid.tsx:526

Whether the given column can be used in the advanced filter bar.

Parameters

column

Column

Column to check.

Returns

boolean

True when the column is filterable.

Inherited from

DataGrid.canFilterColumn

change()

change(handler): void

Defined in: src/ui/widgets/widget.ts:179

Registers a change handler on the widget's DOM node.

Parameters

handler

(e) => void

The change event handler.

Returns

void

Inherited from

DataGrid.change

changeSelect2()

changeSelect2(handler): void

Defined in: src/ui/widgets/widget.ts:188

Registers a change handler that ignores changes originating from combobox setting values.

Parameters

handler

(e) => void

The change event handler.

Returns

void

Inherited from

DataGrid.changeSelect2

createColumns()

protected createColumns(): Column<TItem>[]

Defined in: src/ui/datagrid/datagrid.tsx:562

Creates initial column set for this grid. This column set is then passed to postProcessColumns to adjust widths etc, and then used as the initial columns for the slickgrid.

Returns

Column<TItem>[]

Inherited from

DataGrid.createColumns

createEntityDialog()

protected createEntityDialog(itemType, callback?): Widget<any> | PromiseLike<Widget<any>>

Defined in: src/ui/datagrid/entitygrid.ts:502

Creates a dialog widget for the specified item type, initializing and routing it.

Parameters

itemType

string

Entity type key whose dialog type will be resolved.

callback?

(dlg) => void

Optional callback invoked with the created dialog.

Returns

Widget<any> | PromiseLike<Widget<any>>

The dialog instance or a promise that resolves to it.

createFilterBar()

protected createFilterBar(): void

Defined in: src/ui/datagrid/entitygrid.ts:250

Creates the filter bar and syncs its visibility.

Returns

void

Overrides

DataGrid.createFilterBar

createIncludeDeletedButton()

protected createIncludeDeletedButton(): void

Defined in: src/ui/datagrid/datagrid.tsx:369

Creates the include-deleted toggle button when the row type supports it.

Returns

void

Inherited from

DataGrid.createIncludeDeletedButton

createPager()

protected createPager(): void

Defined in: src/ui/datagrid/datagrid.tsx:1006

Creates the pager widget for this grid.

Returns

void

Inherited from

DataGrid.createPager

createQuickFilters()

protected createQuickFilters(filters?): void

Defined in: src/ui/datagrid/datagrid.tsx:293

Creates the quick filter bar with the given filters.

Parameters

filters?

QuickFilter<Widget<any>, any>[]

Quick filter definitions to render.

Returns

void

Inherited from

DataGrid.createQuickFilters

createQuickSearchInput()

protected createQuickSearchInput(): void

Defined in: src/ui/datagrid/datagrid.tsx:385

Creates the quick search input in the toolbar.

Returns

void

Inherited from

DataGrid.createQuickSearchInput

createSleekColumns()

protected createSleekColumns(): Column<TItem>[]

Defined in: src/ui/datagrid/datagrid.tsx:571

Creates the SleekGrid columns. This method calls createColumns (via getColumns for compatibility) and then post processes them.

Returns

Column<TItem>[]

The SleekGrid columns.

Inherited from

DataGrid.createSleekColumns

createSlickContainer()

protected createSlickContainer(): Fluent

Defined in: src/ui/datagrid/datagrid.tsx:930

Creates the container element that hosts the grid.

Returns

Fluent

The grid container element.

Inherited from

DataGrid.createSlickContainer

createSlickGrid()

protected createSlickGrid(): ISleekGrid<TItem>

Defined in: src/ui/datagrid/datagrid.tsx:580

Creates the underlying SleekGrid instance with the processed columns.

Returns

ISleekGrid<TItem>

The created grid instance.

Inherited from

DataGrid.createSlickGrid

createToolbar()

protected createToolbar(buttons): void

Defined in: src/ui/datagrid/datagrid.tsx:1040

Creates the toolbar with the given buttons.

Parameters

buttons

ToolButton[]

Tool button definitions.

Returns

void

Inherited from

DataGrid.createToolbar

createToolbarExtensions()

protected createToolbarExtensions(): void

Defined in: src/ui/datagrid/entitygrid.ts:109

Creates standard toolbar extensions such as the include-deleted toggle and quick search.

Returns

void

Overrides

DataGrid.createToolbarExtensions

createView()

protected createView(): IRemoteView<TItem>

Defined in: src/ui/datagrid/datagrid.tsx:938

Creates the remote view used for paging and server communication.

Returns

IRemoteView<TItem>

The remote view instance.

Inherited from

DataGrid.createView

dateRangeQuickFilter()

protected dateRangeQuickFilter(field, title?): QuickFilter<DateEditor<DateEditorOptions>, DateTimeEditorOptions>

Defined in: src/ui/datagrid/datagrid.tsx:1522

Creates a date range quick filter definition.

Parameters

field

string

Field name.

title?

string

Optional display title.

Returns

QuickFilter<DateEditor<DateEditorOptions>, DateTimeEditorOptions>

A quick filter definition.

Inherited from

DataGrid.dateRangeQuickFilter

dateTimeRangeQuickFilter()

protected dateTimeRangeQuickFilter(field, title?): QuickFilter<DateTimeEditor<DateTimeEditorOptions>, DateTimeEditorOptions>

Defined in: src/ui/datagrid/datagrid.tsx:1542

Creates a date-time range quick filter definition.

Parameters

field

string

Field name.

title?

string

Optional display title.

Returns

QuickFilter<DateTimeEditor<DateTimeEditorOptions>, DateTimeEditorOptions>

A quick filter definition.

Inherited from

DataGrid.dateTimeRangeQuickFilter

deferRender()

protected deferRender(): boolean

Defined in: src/ui/widgets/widget.ts:98

Determines whether rendering should be deferred until init is called.

Returns

boolean

True to defer rendering.

Inherited from

DataGrid.deferRender

destroy()

destroy(): void

Defined in: src/ui/datagrid/entitygrid.ts:41

Cleans up the route-fixup handler and delegates to the base destroy.

Returns

void

Overrides

DataGrid.destroy

determineText()

protected determineText(getKey): string

Defined in: src/ui/datagrid/datagrid.tsx:1485

Resolves a localized text using the grid's local text db prefix.

Parameters

getKey

(prefix) => string

Callback that builds the text key from the prefix.

Returns

string

The localized text, or null if not found.

Inherited from

DataGrid.determineText

editItem()

protected editItem(entityOrId): void

Defined in: src/ui/datagrid/entitygrid.ts:292

Opens an edit dialog for an existing entity or a new instance.

Parameters

entityOrId

any

Entity instance or identifier to edit.

Returns

void

Overrides

DataGrid.editItem

editItemOfType()

protected editItemOfType(itemType, entityOrId): void

Defined in: src/ui/datagrid/entitygrid.ts:314

Opens an edit dialog for a specific item type, used for polymorphic entities.

Parameters

itemType

string

Entity type key.

entityOrId

any

Entity instance or identifier to edit.

Returns

void

Overrides

DataGrid.editItemOfType

EditLink()

EditLink(props): any

Defined in: src/ui/datagrid/datagrid.tsx:1107

Renders an edit link for the item in current row. Returns a DocumentFragment for non-data rows, and an anchor element otherwise.

Parameters

props

children?

any

The link text. If not provided it will be taken from ctx.escape(ctx.value)

context?

FormatterContext

formatter context (contains item, value etc)

cssClass?

string

Extra CSS class to add to the link element besides s-EditLink. Optional.

id?

string

The id of the entity to link to. If not provided it will be taken from ctx.item[idField]

idField?

string

The name of the field in item that contains the entity id. Defaults to idProperty. Used if id is not provided.

itemType?

string

The item type to link to. Defaults to this.getItemType()

tabindex?

number

The tabindex to assign to the link, default is undefined

tabIndex?

number

Deprecated

Use tabindex.

Returns

any

Inherited from

DataGrid.EditLink

enableAdvancedFiltering()

protected enableAdvancedFiltering(): boolean

Defined in: src/ui/datagrid/datagrid.tsx:963

Whether advanced filtering is enabled for this grid.

Returns

boolean

True when advanced filtering is enabled.

Inherited from

DataGrid.enableAdvancedFiltering

ensureQuickFilterBar()

protected ensureQuickFilterBar(): QuickFilterBar

Defined in: src/ui/datagrid/datagrid.tsx:281

Ensures the quick filter bar exists and returns it.

Returns

QuickFilterBar

The quick filter bar instance.

Inherited from

DataGrid.ensureQuickFilterBar

filterStoreChanged()

protected filterStoreChanged(): void

Defined in: src/ui/datagrid/entitygrid.ts:258

Invoked when the filter store changes; refreshes the filter bar visibility.

Returns

void

Overrides

DataGrid.filterStoreChanged

findById()

protected findById<TElement>(id): TElement

Defined in: src/ui/widgets/widget.ts:163

Finds a child element by its prefix-relative id.

Type Parameters

TElement

TElement extends HTMLElement = HTMLElement

Parameters

id

string

The id relative to the widget's id prefix.

Returns

TElement

The matching element, or null if not found.

Inherited from

DataGrid.findById

findQuickFilter()

protected findQuickFilter<TWidget>(type, field): TWidget

Defined in: src/ui/datagrid/datagrid.tsx:344

Finds a quick filter widget by field name.

Type Parameters

TWidget

TWidget

Parameters

type

(...args) => TWidget

Widget constructor type.

field

string

Field name of the quick filter.

Returns

TWidget

The widget instance.

Inherited from

DataGrid.findQuickFilter

get_readOnly()

get_readOnly(): boolean

Defined in: src/ui/datagrid/datagrid.tsx:1357

Returns whether the grid is in read-only mode.

Returns

boolean

True when read-only.

Inherited from

DataGrid.get_readOnly

getAddButtonCaption()

protected getAddButtonCaption(): string

Defined in: src/ui/datagrid/entitygrid.ts:195

Returns the caption for the add/new button.

Returns

string

Localized add button text.

Overrides

DataGrid.getAddButtonCaption

getButtons()

protected getButtons(): ToolButton[]

Defined in: src/ui/datagrid/entitygrid.ts:203

Builds the grid toolbar buttons including add, refresh, column picker and filter bar.

Returns

ToolButton[]

Array of tool button definitions.

Overrides

DataGrid.getButtons

getColumns()

protected getColumns(): Column<TItem>[]

Defined in: src/ui/datagrid/datagrid.tsx:1203

Returns

Column<TItem>[]

Deprecated

override createColumns

Inherited from

DataGrid.getColumns

getColumnsKey()

protected getColumnsKey(): string

Defined in: src/ui/datagrid/datagrid.tsx:1153

Returns the columns key used to load property items.

Returns

string

The columns key, or null for none.

Inherited from

DataGrid.getColumnsKey

getColumnWidthDelta()

protected getColumnWidthDelta(): number

Defined in: src/ui/datagrid/datagrid.tsx:491

Returns the width delta applied to all columns.

Returns

number

The column width delta.

Inherited from

DataGrid.getColumnWidthDelta

getColumnWidthScale()

protected getColumnWidthScale(): number

Defined in: src/ui/datagrid/datagrid.tsx:499

Returns the width scale applied to all columns.

Returns

number

The column width scale.

Inherited from

DataGrid.getColumnWidthScale

getCssClass()

protected getCssClass(): string

Defined in: src/ui/widgets/widget.ts:106

Returns the CSS class(es) applied to the widget's DOM node.

Returns

string

The space-separated CSS class string.

Inherited from

DataGrid.getCssClass

getCurrentSettings()

getCurrentSettings(flags?): PersistedGridSettings

Defined in: src/ui/datagrid/datagrid.tsx:1754

Returns the current grid settings snapshot.

Parameters

flags?

Optional persistence flags.

Returns

DataGrid.getCurrentSettings

The current grid settings.

Inherited from

getCustomAttribute()

protected getCustomAttribute<TAttr>(attrType, inherit): TAttr

Defined in: src/ui/widgets/widget.ts:220

Returns a custom attribute applied to the widget's type.

Type Parameters

TAttr

TAttr extends CustomAttribute

Parameters

attrType

(...args) => TAttr

The attribute type to look up.

inherit

boolean = true

Whether to search inherited types; defaults to true.

Returns

TAttr

The matching attribute, or null.

Inherited from

DataGrid.getCustomAttribute

getDefaultSortBy()

protected getDefaultSortBy(): any[]

Defined in: src/ui/datagrid/datagrid.tsx:947

Returns the default sort order for the grid.

Returns

any[]

Array of sort descriptors.

Inherited from

DataGrid.getDefaultSortBy

getDeletePermission()

protected getDeletePermission(): string

Defined in: src/ui/datagrid/entitygrid.ts:424

Returns the permission key required to delete a row.

Returns

string

Delete permission or undefined.

getDialogOptions()

protected getDialogOptions(): any

Defined in: src/ui/datagrid/entitygrid.ts:527

Returns default options for the primary entity dialog.

Returns

any

Dialog options.

getDialogOptionsFor()

protected getDialogOptionsFor(itemType): any

Defined in: src/ui/datagrid/entitygrid.ts:536

Returns dialog options for a specific item type.

Parameters

itemType

string

Entity type key.

Returns

any

Dialog options for that type.

getDialogType()

protected getDialogType(): DialogType | PromiseLike<DialogType>

Defined in: src/ui/datagrid/entitygrid.ts:563

Resolves the dialog type for the primary entity; cached and may be loaded lazily.

Returns

DialogType | PromiseLike<DialogType>

Dialog constructor or a promise that resolves to it.

getDialogTypeFor()

protected getDialogTypeFor(itemType): DialogType | PromiseLike<DialogType>

Defined in: src/ui/datagrid/entitygrid.ts:548

Resolves the dialog type for the given item type.

Parameters

itemType

string

Entity type key.

Returns

DialogType | PromiseLike<DialogType>

Dialog constructor or a promise that resolves to it.

getDisplayName()

protected getDisplayName(): string

Defined in: src/ui/datagrid/entitygrid.ts:171

Returns the localized plural display name for the entity.

Returns

string

Display name for the grid title.

getElement()

getElement(): HTMLElement

Defined in: src/ui/datagrid/datagrid.tsx:1788

Returns the root DOM element of the grid widget.

Returns

HTMLElement

The grid container element.

Inherited from

DataGrid.getElement

getEntityType()

protected getEntityType(): string

Defined in: src/ui/datagrid/entitygrid.ts:142

Returns the entity type name derived from the grid class name.

Returns

string

Entity type (e.g. "Administration.User").

getFilterStore()

getFilterStore(): FilterStore

Defined in: src/ui/datagrid/datagrid.tsx:1829

Returns the filter store owned by the grid.

Returns

FilterStore

The filter store, or null if no filter bar exists.

Inherited from

DataGrid.getFilterStore

getGrid()

getGrid(): ISleekGrid<TItem>

Defined in: src/ui/datagrid/datagrid.tsx:1796

Returns the underlying SleekGrid instance.

Returns

ISleekGrid<TItem>

The grid instance.

Inherited from

DataGrid.getGrid

getGridCanLoad()

protected getGridCanLoad(): boolean

Defined in: src/ui/datagrid/datagrid.tsx:1279

Determines whether the grid can load data, notifying onCanSubmit subscribers.

Returns

boolean

True when the grid can load.

Inherited from

DataGrid.getGridCanLoad

getGridField()

getGridField(): Fluent

Defined in: src/ui/widgets/widget.ts:171

Returns the closest .field element containing the widget's DOM node.

Returns

Fluent

A Fluent wrapper for the grid field.

Inherited from

DataGrid.getGridField

getIdProperty()

protected getIdProperty(): string

Defined in: src/ui/datagrid/datagrid.tsx:1423

Returns the id property name for this grid.

Returns

string

The id property name.

Inherited from

DataGrid.getIdProperty

getIncludeColumns()

protected getIncludeColumns(include): void

Defined in: src/ui/datagrid/datagrid.tsx:846

Collects the fields and referenced fields of all columns into the given map.

Parameters

include

Map to populate with column field names.

Returns

void

Inherited from

DataGrid.getIncludeColumns

getInitialTitle()

protected getInitialTitle(): string

Defined in: src/ui/datagrid/entitygrid.ts:118

Returns the initial title for the grid panel.

Returns

string

Localized plural display name.

Overrides

DataGrid.getInitialTitle

getInsertPermission()

protected getInsertPermission(): string

Defined in: src/ui/datagrid/entitygrid.ts:408

Returns the permission key required to insert a row.

Returns

string

Insert permission or undefined if none is configured.

getIsActiveProperty()

protected getIsActiveProperty(): string

Defined in: src/ui/datagrid/datagrid.tsx:1448

Returns the is-active property name for this grid.

Returns

string

The is-active property name.

Inherited from

DataGrid.getIsActiveProperty

getIsDeletedProperty()

protected getIsDeletedProperty(): string

Defined in: src/ui/datagrid/datagrid.tsx:1438

Returns the is-deleted property name for this grid.

Returns

string

The is-deleted property name, or undefined.

Inherited from

DataGrid.getIsDeletedProperty

getItemCssClass()

protected getItemCssClass(item, index): string

Defined in: src/ui/datagrid/datagrid.tsx:443

Returns the CSS class for a grid row based on its active/deleted state.

Parameters

item

TItem

The row item.

index

number

The row index.

Returns

string

The CSS class name, or an empty string.

Inherited from

DataGrid.getItemCssClass

getItemMetadata()

protected getItemMetadata(item, index): any

Defined in: src/ui/datagrid/datagrid.tsx:453

Returns row metadata (e.g. CSS classes) for the given item.

Parameters

item

TItem

The row item.

index

number

The row index.

Returns

any

Row metadata object.

Inherited from

DataGrid.getItemMetadata

getItemName()

protected getItemName(): string

Defined in: src/ui/datagrid/entitygrid.ts:184

Returns the localized singular name for a single entity item.

Returns

string

Singular display name.

getItems()

getItems(): TItem[]

Defined in: src/ui/datagrid/datagrid.tsx:651

Returns the items currently displayed in the grid.

Returns

TItem[]

The grid items.

Inherited from

DataGrid.getItems

getItemType()

protected getItemType(): string

Defined in: src/ui/datagrid/entitygrid.ts:379

Returns the entity item type key used to resolve dialogs and row definitions.

Returns

string

Item type key.

Overrides

DataGrid.getItemType

getLocalTextDbPrefix()

protected getLocalTextDbPrefix(): string

Defined in: src/ui/datagrid/datagrid.tsx:1393

Returns the local text database prefix for this grid.

Returns

string

The local text db prefix.

Inherited from

DataGrid.getLocalTextDbPrefix

getLocalTextPrefix()

protected getLocalTextPrefix(): string

Defined in: src/ui/datagrid/entitygrid.ts:126

Resolves the local text prefix for this grid; falls back to the entity type.

Returns

string

Local text prefix key.

Overrides

DataGrid.getLocalTextPrefix

getPagerOptions()

protected getPagerOptions(): PagerOptions

Defined in: src/ui/datagrid/datagrid.tsx:995

Returns the pager options for this grid.

Returns

PagerOptions

Pager options.

Inherited from

DataGrid.getPagerOptions

getPersistedSettings()

protected getPersistedSettings(): PersistedGridSettings | Promise<PersistedGridSettings>

Defined in: src/ui/datagrid/datagrid.tsx:1630

Retrieves the persisted grid settings from storage.

Returns

PersistedGridSettings | Promise<PersistedGridSettings>

The persisted settings, or a promise resolving to them.

Inherited from

DataGrid.getPersistedSettings

getPersistenceKey()

protected getPersistenceKey(): string

Defined in: src/ui/datagrid/datagrid.tsx:1603

Returns the key used to store grid settings.

Returns

string

The persistence key.

Inherited from

DataGrid.getPersistenceKey

getPersistenceStorage()

protected getPersistenceStorage(): SettingStorage

Defined in: src/ui/datagrid/datagrid.tsx:1593

Returns the storage used for grid persistence.

Returns

DataGrid.getPersistenceStorage

The persistence storage.

Inherited from

getPropertyItems()

protected getPropertyItems(): PropertyItem[]

Defined in: src/ui/datagrid/datagrid.tsx:1161

Returns the property items for this grid.

Returns

PropertyItem[]

The property items.

Inherited from

DataGrid.getPropertyItems

getPropertyItemsData()

protected getPropertyItemsData(): PropertyItemsData

Defined in: src/ui/datagrid/datagrid.tsx:1169

Loads the property items data, either from script data or local items.

Returns

PropertyItemsData

The property items data.

Inherited from

DataGrid.getPropertyItemsData

getPropertyItemsDataAsync()

protected getPropertyItemsDataAsync(): Promise<PropertyItemsData>

Defined in: src/ui/datagrid/datagrid.tsx:1193

Asynchronously loads the property items data.

Returns

Promise<PropertyItemsData>

A promise resolving to the property items data.

Inherited from

DataGrid.getPropertyItemsDataAsync

getQuickFilters()

protected getQuickFilters(): QuickFilter<Widget<any>, any>[]

Defined in: src/ui/datagrid/datagrid.tsx:319

Returns the quick filter definitions derived from the grid columns.

Returns

QuickFilter<Widget<any>, any>[]

Quick filter definitions for columns marked as quick filters.

Inherited from

DataGrid.getQuickFilters

getQuickSearchFields()

protected getQuickSearchFields(): QuickSearchField[]

Defined in: src/ui/datagrid/datagrid.tsx:378

Returns the quick search fields available for this grid.

Returns

QuickSearchField[]

The quick search fields, or null for none.

Inherited from

DataGrid.getQuickSearchFields

getRowDefinition()

protected getRowDefinition(): IRowDefinition

Defined in: src/ui/datagrid/datagrid.tsx:1383

Returns the row definition for this grid.

Returns

IRowDefinition

The row definition, or null for none.

Inherited from

DataGrid.getRowDefinition

getService()

protected getService(): string

Defined in: src/ui/datagrid/entitygrid.ts:342

Returns the service endpoint path for the entity (e.g. "Administration/User").

Returns

string

Service path derived from the entity type.

getServiceMethod()

protected getServiceMethod(): string

Defined in: src/ui/datagrid/entitygrid.ts:353

Returns the service method name for listing entities.

Returns

string

Service method (defaults to "/List").

getServiceUrl()

protected getServiceUrl(): string

Defined in: src/ui/datagrid/entitygrid.ts:361

Returns the absolute URL for the list service endpoint.

Returns

string

Resolved service URL.

getSlickOptions()

protected getSlickOptions(): GridOptions

Defined in: src/ui/datagrid/datagrid.tsx:1247

Returns the SleekGrid options for this grid.

Returns

GridOptions

Grid options.

Inherited from

DataGrid.getSlickOptions

getTitle()

getTitle(): string

Defined in: src/ui/datagrid/datagrid.tsx:1052

Returns the current grid title text.

Returns

string

The title text, or null if no title is set.

Inherited from

DataGrid.getTitle

getUpdatePermission()

protected getUpdatePermission(): string

Defined in: src/ui/datagrid/entitygrid.ts:416

Returns the permission key required to update a row.

Returns

string

Update permission or undefined.

getView()

getView(): IRemoteView<TItem>

Defined in: src/ui/datagrid/datagrid.tsx:1821

Returns the remote view used for paging and server communication.

Returns

IRemoteView<TItem>

The remote view instance.

Inherited from

DataGrid.getView

getViewOptions()

protected getViewOptions(): RemoteViewOptions

Defined in: src/ui/datagrid/entitygrid.ts:369

Returns view options including the service URL.

Returns

RemoteViewOptions

Remote view options with URL populated.

Overrides

DataGrid.getViewOptions

gridPersistenceFlags()

protected gridPersistenceFlags(): GridPersistenceFlags

Defined in: src/ui/datagrid/datagrid.tsx:1620

Returns the default persistence flags for this grid.

Returns

DataGrid.gridPersistenceFlags

Grid persistence flags.

Inherited from

handleGridClick()

protected handleGridClick(e): void

Defined in: src/ui/datagrid/datagrid.tsx:676

Handles grid cell click events by delegating to onClick.

Parameters

e

CellMouseEvent

Cell mouse event.

Returns

void

Inherited from

DataGrid.handleGridClick

handleGridColumnsReordered()

protected handleGridColumnsReordered(): void

Defined in: src/ui/datagrid/datagrid.tsx:683

Persists settings when columns are reordered.

Returns

void

Inherited from

DataGrid.handleGridColumnsReordered

handleGridColumnsResized()

protected handleGridColumnsResized(): void

Defined in: src/ui/datagrid/datagrid.tsx:690

Persists settings when columns are resized.

Returns

void

Inherited from

DataGrid.handleGridColumnsResized

handleGridSort()

protected handleGridSort(e): void

Defined in: src/ui/datagrid/datagrid.tsx:667

Handles grid sort events by applying the sort and persisting settings.

Parameters

e

GridSortEvent

Grid sort event.

Returns

void

Inherited from

DataGrid.handleGridSort

handleRoute()

protected handleRoute(e): void

Defined in: src/ui/datagrid/entitygrid.ts:50

Handles hash-based routing for new/edit dialog invocations.

Parameters

e

HandleRouteEvent

Route event containing the hash fragment and navigation metadata.

Returns

void

handleViewFilter()

protected handleViewFilter(item): boolean

Defined in: src/ui/datagrid/datagrid.tsx:790

Filters a view item, notifying the onFiltering subscribers.

Parameters

item

TItem

The item to filter.

Returns

boolean

True when the item matches.

Inherited from

DataGrid.handleViewFilter

handleViewProcessData()

protected handleViewProcessData(response): ListResponse<TItem>

Defined in: src/ui/datagrid/datagrid.tsx:804

Processes a list response, notifying the onProcessData subscribers.

Parameters

response

ListResponse<TItem>

The list response.

Returns

ListResponse<TItem>

The processed response.

Inherited from

DataGrid.handleViewProcessData

handleViewSubmit()

protected handleViewSubmit(): boolean

Defined in: src/ui/datagrid/datagrid.tsx:815

Handles view submission, notifying the onSubmitting subscribers.

Returns

boolean

True when the submit should proceed.

Inherited from

DataGrid.handleViewSubmit

hasDeletePermission()

protected hasDeletePermission(): boolean

Defined in: src/ui/datagrid/entitygrid.ts:432

Checks whether the current user may delete rows.

Returns

boolean

True when deletion is allowed.

hasInsertPermission()

protected hasInsertPermission(): boolean

Defined in: src/ui/datagrid/entitygrid.ts:441

Checks whether the current user may insert rows.

Returns

boolean

True when insertion is allowed.

hasUpdatePermission()

protected hasUpdatePermission(): boolean

Defined in: src/ui/datagrid/entitygrid.ts:450

Checks whether the current user may update rows.

Returns

boolean

True when updates are allowed.

init()

init(): this

Defined in: src/ui/widgets/widget.ts:243

Initializes the widget, rendering its contents if rendering was deferred.

Returns

this

This widget instance.

Inherited from

DataGrid.init

initDialog()

protected initDialog(dialog): void

Defined in: src/ui/datagrid/entitygrid.ts:468

Initializes a dialog bound to the primary item type.

Parameters

dialog

Widget<any>

Dialog instance to initialize.

Returns

void

initEntityDialog()

protected initEntityDialog(itemType, dialog): void

Defined in: src/ui/datagrid/entitygrid.ts:482

Initializes a dialog for the given item type, wiring data-change and routing.

Parameters

itemType

string

Entity type key.

dialog

Widget<any>

Dialog instance to initialize.

Returns

void

initializeFilterBar()

protected initializeFilterBar(): void

Defined in: src/ui/datagrid/datagrid.tsx:536

Initializes the filter bar store with the filterable columns.

Returns

void

Inherited from

DataGrid.initializeFilterBar

initialPopulate()

protected initialPopulate(): void

Defined in: src/ui/datagrid/datagrid.tsx:506

Performs the initial data population, optionally waiting until visible.

Returns

void

Inherited from

DataGrid.initialPopulate

initSleekGrid()

protected initSleekGrid(): void

Defined in: src/ui/datagrid/datagrid.tsx:592

Hook for subclasses to initialize the grid after creation.

Returns

void

Inherited from

DataGrid.initSleekGrid

internalRefresh()

protected internalRefresh(): void

Defined in: src/ui/datagrid/datagrid.tsx:1331

Performs the actual data refresh by populating the view.

Returns

void

Inherited from

DataGrid.internalRefresh

internalRenderContents()

internalRenderContents(): void

Defined in: src/ui/widgets/widget.ts:266

Renders the widget's contents and runs any queued after-render callbacks.

Returns

void

Inherited from

DataGrid.internalRenderContents

invokeSubmitHandlers()

protected invokeSubmitHandlers(): void

Defined in: src/ui/datagrid/datagrid.tsx:1573

Invokes the quick filter submit handlers with the current view params.

Returns

void

Inherited from

DataGrid.invokeSubmitHandlers

itemAt()

itemAt(row): TItem

Defined in: src/ui/datagrid/datagrid.tsx:626

Returns the item at the given row index.

Parameters

row

number

Row index.

Returns

TItem

The item at that row.

Inherited from

DataGrid.itemAt

itemId()

itemId(item): any

Defined in: src/ui/datagrid/datagrid.tsx:635

Returns the id of the given item using the grid id property.

Parameters

item

TItem

The item.

Returns

any

The item id.

Inherited from

DataGrid.itemId

itemLink()

protected itemLink(itemType?, idField?, text?, cssClass?, encode?): Format<TItem>

Defined in: src/ui/datagrid/datagrid.tsx:1101

Creates a formatter that renders a link to an item.

Parameters

itemType?

string

Item type key; defaults to the grid item type.

idField?

string

Id field name; defaults to the grid id property.

text?

Format<TItem>

Optional text formatter.

cssClass?

(ctx) => string

Optional CSS class formatter.

encode?

boolean = true

Whether to HTML-encode the link text.

Returns

Format<TItem>

A formatter function.

Inherited from

DataGrid.itemLink

layout()

protected layout(): void

Defined in: src/ui/datagrid/datagrid.tsx:241

Recalculates the grid layout, handling responsive height behavior.

Returns

void

Inherited from

DataGrid.layout

legacyTemplateRender()

protected legacyTemplateRender(): boolean

Defined in: src/ui/widgets/widget.ts:291

Renders the widget from a legacy getTemplate string, if defined.

Returns

boolean

True if a legacy template was rendered.

Inherited from

DataGrid.legacyTemplateRender

markupReady()

protected markupReady(): void

Defined in: src/ui/datagrid/datagrid.tsx:922

Hook invoked when the grid markup is ready after data changes.

Returns

void

Inherited from

DataGrid.markupReady

newRefreshButton()

protected newRefreshButton(noText?): ToolButton

Defined in: src/ui/datagrid/entitygrid.ts:268

Creates a refresh toolbar button.

Parameters

noText?

boolean

When true, only an icon with a hint is shown.

Returns

ToolButton

Tool button definition for refreshing the grid.

onClick()

protected onClick(e, row, cell): void

Defined in: src/ui/datagrid/datagrid.tsx:749

Handles cell clicks, opening edit links when clicked.

Parameters

e

Event

Click event.

row

number

Row index.

cell

number

Cell index.

Returns

void

Inherited from

DataGrid.onClick

onViewFilter()

protected onViewFilter(item): boolean

Defined in: src/ui/datagrid/datagrid.tsx:838

Hook for subclasses to filter view items.

Parameters

item

TItem

The item to filter.

Returns

boolean

True when the item should be included.

Inherited from

DataGrid.onViewFilter

onViewProcessData()

protected onViewProcessData(response): ListResponse<TItem>

Defined in: src/ui/datagrid/datagrid.tsx:829

Hook for subclasses to process a list response before it is applied.

Parameters

response

ListResponse<TItem>

The list response.

Returns

ListResponse<TItem>

The processed response.

Inherited from

DataGrid.onViewProcessData

onViewSubmit()

protected onViewSubmit(): boolean

Defined in: src/ui/datagrid/datagrid.tsx:910

Hook invoked before the view submits; prepares parameters and checks loadability.

Returns

boolean

True when the view can load.

Inherited from

DataGrid.onViewSubmit

persistenceLock()

persistenceLock(): void

Defined in: src/ui/datagrid/datagrid.tsx:1720

Increments the persistence lock, preventing settings from being persisted.

Returns

void

Inherited from

DataGrid.persistenceLock

persistenceUnlock()

persistenceUnlock(): void

Defined in: src/ui/datagrid/datagrid.tsx:1727

Decrements the persistence lock.

Returns

void

Inherited from

DataGrid.persistenceUnlock

persistSettings()

persistSettings(flags?): void | Promise<void>

Defined in: src/ui/datagrid/datagrid.tsx:1736

Persists the current grid settings to storage.

Parameters

flags?

DataGrid.persistSettings

Optional persistence flags.

Returns

void | Promise<void>

Void or a promise that resolves when the write completes.

Inherited from

populateLock()

protected populateLock(): void

Defined in: src/ui/datagrid/datagrid.tsx:1264

Locks the view against population.

Returns

void

Inherited from

DataGrid.populateLock

populateUnlock()

protected populateUnlock(): void

Defined in: src/ui/datagrid/datagrid.tsx:1271

Unlocks the view population.

Returns

void

Inherited from

DataGrid.populateUnlock

populateWhenVisible()

protected populateWhenVisible(): boolean

Defined in: src/ui/datagrid/datagrid.tsx:974

Whether the grid should wait until visible before populating data.

Returns

boolean

True when population waits for visibility.

Inherited from

DataGrid.populateWhenVisible

postProcessColumns()

protected postProcessColumns(columns): Column<any>[]

Defined in: src/ui/datagrid/datagrid.tsx:466

Applies defaults and width adjustments to the given columns.

Parameters

columns

Column<any>[]

Columns to post-process.

Returns

Column<any>[]

The processed columns.

Inherited from

DataGrid.postProcessColumns

prepareSubmit()

prepareSubmit(): boolean

Defined in: src/ui/datagrid/datagrid.tsx:1293

Prepares submit arguments in this.view.params by calling this.view.onSubmit if available, or this.handleViewSubmit if not. Note that if getGridCanLoad returns false, the prepared arguments might be in an incomplete state.

Returns

boolean

True when the submit should proceed.

Inherited from

DataGrid.prepareSubmit

propertyItemsReady()

protected propertyItemsReady(itemsData): void

Defined in: src/ui/datagrid/datagrid.tsx:178

Called once property items are available; creates the grid, filter bar, pager, quick filters, and restores persisted settings.

Parameters

itemsData

PropertyItemsData

Property items and additional items for the grid.

Returns

void

Inherited from

DataGrid.propertyItemsReady

propertyItemsToColumns()

protected propertyItemsToColumns(propertyItems): Column<any>[]

Defined in: src/ui/datagrid/datagrid.tsx:1232

Converts property items to grid columns, wrapping edit-link columns.

Parameters

propertyItems

PropertyItem[]

Property items to convert.

Returns

Column<any>[]

The grid columns.

Inherited from

DataGrid.propertyItemsToColumns

quickFilterChange()

protected quickFilterChange(e): void

Defined in: src/ui/datagrid/datagrid.tsx:1583

Handles quick filter changes by persisting settings and refreshing.

Parameters

e

Event

Change event.

Returns

void

Inherited from

DataGrid.quickFilterChange

refresh()

refresh(): void

Defined in: src/ui/datagrid/datagrid.tsx:1305

Refreshes the grid data, waiting for visibility if configured to do so.

Returns

void

Inherited from

DataGrid.refresh

refreshIfNeeded()

protected refreshIfNeeded(): void

Defined in: src/ui/datagrid/datagrid.tsx:1321

Refreshes the grid if a refresh was requested while hidden.

Returns

void

Inherited from

DataGrid.refreshIfNeeded

render()

render(): any

Defined in: src/ui/widgets/widget.ts:253

Returns the main element for this widget or the document fragment. As widgets may get their elements from props unlike regular JSX widgets, this method should not be overridden. Override renderContents() instead.

Returns

any

Inherited from

DataGrid.render

renderContents()

protected renderContents(): any

Defined in: src/ui/widgets/widget.ts:281

Renders the widget's contents. Override this to provide custom content.

Returns

any

The rendered contents.

Inherited from

DataGrid.renderContents

resizeCanvas()

protected resizeCanvas(): void

Defined in: src/ui/datagrid/datagrid.tsx:1462

Resizes the underlying grid canvas.

Returns

void

Inherited from

DataGrid.resizeCanvas

restoreSettings()

protected restoreSettings(settings?, flags?): void | Promise<void>

Defined in: src/ui/datagrid/datagrid.tsx:1655

Restores grid settings from the given settings or from storage.

Parameters

settings?

Optional settings to restore; defaults to persisted settings.

flags?

DataGrid.restoreSettings

Optional persistence flags.

Returns

void | Promise<void>

Void or a promise that resolves when restoration completes.

Inherited from

restoreSettingsFrom()

protected restoreSettingsFrom(settings, flags?): void

Defined in: src/ui/datagrid/datagrid.tsx:1671

Restores grid state from a persisted settings snapshot.

Parameters

settings

The settings to restore.

flags?