Skip to content

@serenity-is/corelib / CheckTreeEditor

Class: CheckTreeEditor<TItem, P>

Defined in: src/ui/editors/checktreeeditor.tsx:46

A grid-based editor that renders a hierarchical tree of checkboxes.

Extends

Extended by

Type Parameters

TItem

TItem extends CheckTreeItem<TItem>

The tree item type.

P

P = { }

Widget props type.

Implements

Constructors

Constructor

new CheckTreeEditor<TItem, P>(props): CheckTreeEditor<TItem, P>

Defined in: src/ui/editors/checktreeeditor.tsx:60

Creates a check tree editor.

Parameters

props

EditorProps<P>

Widget props.

Returns

CheckTreeEditor<TItem, P>

Overrides

DataGrid.constructor

Properties

domNode

readonly domNode: HTMLElement

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

The DOM node this widget is bound to.

Inherited from

DataGrid.domNode


filterBar

protected filterBar: FilterDisplayBar

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

The advanced filter bar widget.

Inherited from

DataGrid.filterBar


idPrefix

readonly idPrefix: string

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

The id prefix used for this widget's child element ids.

Inherited from

DataGrid.idPrefix


onAfterInit

readonly onAfterInit: PubSub<DataGridEvent>

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

Raised after this grid is initialized.

Inherited from

DataGrid.onAfterInit


onCanSubmit

readonly onCanSubmit: PubSub<DataGridSubmitEvent>

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

Raised to determine whether the grid can submit its view.

Inherited from

DataGrid.onCanSubmit


onDataChanged

readonly onDataChanged: PubSub<DataGridEvent>

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

Raised when the grid data changes.

Inherited from

DataGrid.onDataChanged


onFiltering

readonly onFiltering: PubSub<DataGridFilteringEvent<TItem>>

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

Raised while filtering items in the view.

Inherited from

DataGrid.onFiltering


onPersistence

readonly onPersistence: PubSub<DataGridPersistenceEvent>

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

Raised before/after persisting or restoring grid settings.

Inherited from

DataGrid.onPersistence


onProcessData

readonly onProcessData: PubSub<DataGridProcessEvent<TItem>>

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

Raised when the view processes a list response.

Inherited from

DataGrid.onProcessData


onSetViewParams

readonly onSetViewParams: PubSub<DataGridEvent>

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

Raised after view parameters are prepared for submission.

Inherited from

DataGrid.onSetViewParams


onSubmitting

readonly onSubmitting: PubSub<DataGridSubmitEvent>

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

Raised to determine whether the view submit should proceed.

Inherited from

DataGrid.onSubmitting


openDialogsAsPanel

openDialogsAsPanel: boolean

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

Whether dialogs opened from this grid should be shown as panels.

Inherited from

DataGrid.openDialogsAsPanel


options

protected readonly options: WidgetProps<P>

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

The widget's options/props.

Inherited from

DataGrid.options


propertyItemsData

protected propertyItemsData: PropertyItemsData

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

The property items data for this grid.

Inherited from

DataGrid.propertyItemsData


quickFiltersBar

protected quickFiltersBar: QuickFilterBar

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

The quick filter bar widget.

Inherited from

DataGrid.quickFiltersBar


quickFiltersDiv

protected quickFiltersDiv: Fluent

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

The quick filters container element.

Inherited from

DataGrid.quickFiltersDiv


restoringSettings

protected restoringSettings: number

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

Counter tracking nested settings restoration.

Inherited from

DataGrid.restoringSettings


slickContainer

protected slickContainer: Fluent

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

The container element that hosts the grid.

Inherited from

DataGrid.slickContainer


titleDiv

protected titleDiv: Fluent

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

The title element.

Inherited from

DataGrid.titleDiv


toolbar

protected toolbar: Toolbar

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

The toolbar widget.

Inherited from

DataGrid.toolbar


uniqueName

readonly uniqueName: string

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

A unique name for this widget instance, used for event namespacing.

Inherited from

DataGrid.uniqueName


view

view: IRemoteView<TItem>

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

The remote view used for paging and server communication.

Inherited from

DataGrid.view


[typeInfo]

static [typeInfo]: EditorTypeInfo<"Serenity.">

Defined in: src/ui/editors/checktreeeditor.tsx:48

Implementation of

IReadOnly.[typeInfo]

Overrides

DataGrid.[typeInfo]


defaultOptions

readonly static defaultOptions: object = dataGridDefaults

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

Default options shared by all data grid instances.

columnWidthDelta

columnWidthDelta: number

Default column width delta. This value if specified, is added to the width of columns defined server side. Default is null

columnWidthScale

columnWidthScale: number

Default column width scale. This value if specified, is multiplied with the width of columns defined server side. Default is null

enableAdvancedFiltering

enableAdvancedFiltering: boolean | (grid) => boolean

Controls whether to enable advanced filtering, e.g. via filter dialog/bar. Default is null.

openDialogsAsPanel

openDialogsAsPanel: boolean

Controls whether to open dialogs as panels. Default is null.

persistenceFlags

persistenceFlags: GridPersistenceFlags = defaultGridPersistenceFlags

Default persistence flags. Defaults are true except quickSearch and quickFilterText

persistenceStorage

persistenceStorage: SettingStorage

Default persistence storage. Default is null

rowHeight

rowHeight: number

Default row height. Default is null.

Inherited from

DataGrid.defaultOptions


isComponent

readonly static isComponent: true = true

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

Inherited from

DataGrid.isComponent


onAfterInit

readonly static onAfterInit: PubSub<DataGridEvent>

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

Static event raised after any grid is initialized.

Inherited from

DataGrid.onAfterInit

Accessors

allColumns

Get Signature

get allColumns(): Column<any>[]

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

All columns including hidden ones.

Returns

Column<any>[]

All columns from the underlying SleekGrid.

Inherited from

DataGrid.allColumns


columns

Get Signature

get columns(): Column<TItem>[]

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

The currently visible columns.

Returns

Column<TItem>[]

Inherited from

DataGrid.columns


element

Get Signature

get element(): Fluent

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

Returns a Fluent(this.domNode) object

Returns

Fluent

Inherited from

DataGrid.element


initialSettings

Get Signature

get initialSettings(): PersistedGridSettings

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

The initial persisted settings captured at startup.

Returns

PersistedGridSettings

Set Signature

set initialSettings(value): void

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

Sets the initial persisted settings.

Parameters
value

PersistedGridSettings

Returns

void

Inherited from

DataGrid.initialSettings


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


value

Get Signature

get value(): string[]

Defined in: src/ui/editors/checktreeeditor.tsx:561

Returns the selected item ids.

Returns

string[]

Array of selected ids.

Set Signature

set value(v): void

Defined in: src/ui/editors/checktreeeditor.tsx:604

Sets the selected item ids.

Parameters
v

string[]

Array of ids to select.

Returns

void


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

SettingStorage

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

SettingStorage

Persistence storage to set.

Returns

void

Inherited from

DataGrid.defaultPersistanceStorage


defaultPersistenceStorage

Get Signature

get static defaultPersistenceStorage(): SettingStorage

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

Default storage used for grid persistence.

Returns

SettingStorage

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

SettingStorage

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

Returns

void

Inherited from

DataGrid.defaultPersistenceStorage


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


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


allDescendantsSelected()

protected allDescendantsSelected(item): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:398

Whether all descendants of an item are selected.

Parameters

item

TItem

The item.

Returns

boolean

True when all descendants are selected.


allItemsSelected()

protected allItemsSelected(): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:382

Whether all items are selected.

Returns

boolean

True when all items are selected.


anyDescendantsSelected()

protected anyDescendantsSelected(item): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:427

Whether any descendant of an item is selected.

Parameters

item

TItem

The item.

Returns

boolean

True when any descendant is selected.


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<any>[]

Defined in: src/ui/editors/checktreeeditor.tsx:446

Creates the grid columns for the tree.

Returns

Column<any>[]

The columns.

Overrides

DataGrid.createColumns


createFilterBar()

protected createFilterBar(): void

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

Creates the advanced filter bar and initializes its store.

Returns

void

Inherited from

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/datagrid.tsx:274

Hook for subclasses to add extra toolbar buttons or controls.

Returns

void

Inherited from

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/datagrid.tsx:398

Cleans up event subscriptions, widgets, and the underlying grid.

Returns

void

Inherited from

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/datagrid.tsx:725

Opens an edit dialog for the given entity or id.

Parameters

entityOrId

any

Entity instance or identifier to edit.

Returns

void

Inherited from

DataGrid.editItem


editItemOfType()

protected editItemOfType(itemType, entityOrId): void

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

Opens an edit dialog for a specific item type.

Parameters

itemType

string

Item type key.

entityOrId

any

Entity instance or identifier to edit.

Returns

void

Inherited from

DataGrid.editItemOfType


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/datagrid.tsx:549

Handles filter store changes by persisting settings and refreshing.

Returns

void

Inherited from

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/editors/checktreeeditor.tsx:533

Returns whether the editor is read-only.

Returns

boolean

True when read-only.

Implementation of

IReadOnly.get_readOnly

Overrides

DataGrid.get_readOnly


getAddButtonCaption()

protected getAddButtonCaption(): string

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

Returns the caption for the add/new button.

Returns

string

The add button caption.

Inherited from

DataGrid.getAddButtonCaption


getButtons()

protected getButtons(): ToolButton[]

Defined in: src/ui/editors/checktreeeditor.tsx:133

Returns the toolbar buttons for the editor.

Returns

ToolButton[]

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?

GridPersistenceFlags

Optional persistence flags.

Returns

PersistedGridSettings

The current grid settings.

Inherited from

DataGrid.getCurrentSettings


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


getDelimited()

protected getDelimited(): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:418

Returns whether the value is delimited.

Returns

boolean

True when delimited.


getDescendantsSelected()

protected getDescendantsSelected(item): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:351

Whether all descendants of an item are selected.

Parameters

item

TItem

The item.

Returns

boolean

True when all descendants are selected.


getEditValue()

getEditValue(property, target): void

Defined in: src/ui/editors/checktreeeditor.tsx:112

Gets the edit value into a target object.

Parameters

property

PropertyItem

The property item.

target

any

The target object.

Returns

void

Implementation of

IGetEditValue.getEditValue


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


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/editors/checktreeeditor.tsx:71

Returns the id property name.

Returns

string

"id".

Overrides

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


getInitialCollapse()

protected getInitialCollapse(): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:228

Returns the initial collapse state for tree rows.

Returns

boolean

True when collapsed.


getInitialTitle()

protected getInitialTitle(): string

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

Returns the initial title shown above the grid.

Returns

string

The title text, or null for no title.

Inherited from

DataGrid.getInitialTitle


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


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


getItemText()

protected getItemText(ctx): FormatterResult

Defined in: src/ui/editors/checktreeeditor.tsx:474

Returns the display text for an item.

Parameters

ctx

FormatterContext

The formatter context.

Returns

FormatterResult

The item text.


getItemType()

protected getItemType(): string

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

Returns the item type key for this grid.

Returns

string

The item type key.

Inherited from

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/datagrid.tsx:1409

Returns the local text prefix for this grid.

Returns

string

The local text prefix, or undefined.

Inherited from

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

SettingStorage

The persistence storage.

Inherited from

DataGrid.getPersistenceStorage


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


getSelectAllText()

protected getSelectAllText(): string

Defined in: src/ui/editors/checktreeeditor.tsx:170

Returns the text for the select-all button.

Returns

string

The select-all text.


getSlickOptions()

protected getSlickOptions(): GridOptions

Defined in: src/ui/editors/checktreeeditor.tsx:482

Returns the grid options for the editor.

Returns

GridOptions

Grid options.

Overrides

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


getTreeItems()

protected getTreeItems(): TItem[]

Defined in: src/ui/editors/checktreeeditor.tsx:79

Returns the tree items to display.

Returns

TItem[]

The tree items.


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<any>

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

Returns the remote view options for this grid.

Returns

RemoteViewOptions<any>

Remote view options.

Inherited from

DataGrid.getViewOptions


gridPersistenceFlags()

protected gridPersistenceFlags(): GridPersistenceFlags

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

Returns the default persistence flags for this grid.

Returns

GridPersistenceFlags

Grid persistence flags.

Inherited from

DataGrid.gridPersistenceFlags


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


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


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


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/editors/checktreeeditor.tsx:185

Initializes the grid with tree-specific styling.

Returns

void

Overrides

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


isThreeStateHierarchy()

protected isThreeStateHierarchy(): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:178

Whether the tree uses a three-state hierarchy.

Returns

boolean

True when three-state.


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


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


itemSelectedChanged()

protected itemSelectedChanged(item): void

Defined in: src/ui/editors/checktreeeditor.tsx:163

Hook invoked when an item's selection changes.

Parameters

item

TItem

The item.

Returns

void


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


moveSelectedUp()

protected moveSelectedUp(): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:523

Whether selected items should be moved to the top.

Returns

boolean

True when moving selected items up.


onClick()

protected onClick(e, row, cell): void

Defined in: src/ui/editors/checktreeeditor.tsx:254

Handles cell clicks, toggling checkboxes and tree expansion.

Parameters

e

Event

Click event.

row

number

Row index.

cell

number

Cell index.

Returns

void

Overrides

DataGrid.onClick


onViewFilter()

protected onViewFilter(item): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:198

Filters view items for the tree hierarchy.

Parameters

item

TItem

The item to filter.

Returns

boolean

True when the item matches.

Overrides

DataGrid.onViewFilter


onViewProcessData()

protected onViewProcessData(response): ListResponse<TItem>

Defined in: src/ui/editors/checktreeeditor.tsx:237

Processes the list response, setting tree indents.

Parameters

response

ListResponse<TItem>

The list response.

Returns

ListResponse<TItem>

The processed response.

Overrides

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?

GridPersistenceFlags

Optional persistence flags.

Returns

void | Promise<void>

Void or a promise that resolves when the write completes.

Inherited from

DataGrid.persistSettings


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?

PersistedGridSettings

Optional settings to restore; defaults to persisted settings.

flags?

GridPersistenceFlags

Optional persistence flags.

Returns

void | Promise<void>

Void or a promise that resolves when restoration completes.

Inherited from

DataGrid.restoreSettings


restoreSettingsFrom()

protected restoreSettingsFrom(settings, flags?): void

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

Restores grid state from a persisted settings snapshot.

Parameters

settings

PersistedGridSettings

The settings to restore.

flags?

GridPersistenceFlags

Optional persistence flags.

Returns

void

Inherited from

DataGrid.restoreSettingsFrom


rowCount()

rowCount(): number

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

Returns the number of rows in the grid.

Returns

number

The row count.

Inherited from

DataGrid.rowCount


set_readOnly()

set_readOnly(value): void

Defined in: src/ui/editors/checktreeeditor.tsx:541

Sets whether the editor is read-only.

Parameters

value

boolean

True to enable read-only mode.

Returns

void

Implementation of

IReadOnly.set_readOnly

Overrides

DataGrid.set_readOnly


setAllSubTreeSelected()

protected setAllSubTreeSelected(item, selected): boolean

Defined in: src/ui/editors/checktreeeditor.tsx:361

Sets the selection state of all descendants of an item.

Parameters

item

TItem

The item.

selected

boolean

The selection state.

Returns

boolean

True when any item changed.


setCriteriaParameter()

protected setCriteriaParameter(): void

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

Sets the Criteria view parameter from the active filter store criteria.

Returns

void

Inherited from

DataGrid.setCriteriaParameter


setEditValue()

setEditValue(source, property): void

Defined in: src/ui/editors/checktreeeditor.tsx:124

Sets the edit value from a source object.

Parameters

source

any

The source object.

property

PropertyItem

The property item.

Returns

void

Implementation of

ISetEditValue.setEditValue


setEquality()

protected setEquality(field, value): void

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

Sets an equality filter on the view parameters.

Parameters

field

string

Field name.

value

any

Equality value.

Returns

void

Inherited from

DataGrid.setEquality


setIncludeColumnsParameter()

protected setIncludeColumnsParameter(): void

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

Sets the IncludeColumns view parameter from the grid columns.

Returns

void

Inherited from

DataGrid.setIncludeColumnsParameter


setInitialSortOrder()

protected setInitialSortOrder(): void

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

Applies the default sort order to the grid and view.

Returns

void

Inherited from

DataGrid.setInitialSortOrder


setItems()

setItems(value): void

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

Sets the items displayed in the grid.

Parameters

value

TItem[]

The items to display.

Returns

void

Inherited from

DataGrid.setItems


setTitle()

setTitle(value): void

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

Sets the grid title text, creating or removing the title element as needed.

Parameters

value

string

The title text, or null to remove the title.

Returns

void

Inherited from

DataGrid.setTitle


setViewParams()

protected setViewParams(): void

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

Prepares all view parameters and notifies the onSetViewParams subscribers.

Returns

void

Inherited from

DataGrid.setViewParams


sortItems()

protected sortItems(): void

Defined in: src/ui/editors/checktreeeditor.tsx:491

Sorts items, moving selected items to the top.

Returns

void


subDialogDataChange()

protected subDialogDataChange(): void

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

Refreshes the grid when a sub-dialog reports a data change.

Returns

void

Inherited from

DataGrid.subDialogDataChange


syncOrAsyncThen()

protected syncOrAsyncThen<T>(syncMethod, asyncMethod, then): void

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

Runs a method synchronously or asynchronously depending on the widget's useAsync flag, then invokes a continuation.

Type Parameters

T

T

Parameters

syncMethod

() => T

The synchronous method to run.

asyncMethod

() => PromiseLike<T>

The asynchronous method to run.

then

(v) => void

The continuation invoked with the result.

Returns

void

Inherited from

DataGrid.syncOrAsyncThen


tryFindQuickFilter()

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

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

Tries to find 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, or null if not found.

Inherited from

DataGrid.tryFindQuickFilter


updateFlags()

protected updateFlags(): void

Defined in: src/ui/editors/checktreeeditor.tsx:309

Updates the selection flags for all items.

Returns

void


updateInterface()

updateInterface(): void

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

Updates the toolbar interface to reflect the current grid state.

Returns

void

Inherited from

DataGrid.updateInterface


updateItems()

protected updateItems(): void

Defined in: src/ui/editors/checktreeeditor.tsx:86

Loads the tree items into the view.

Returns

void


updateSelectAll()

protected updateSelectAll(): void

Defined in: src/ui/editors/checktreeeditor.tsx:300

Updates the select-all button state.

Returns

void


useAsync()

protected useAsync(): boolean

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

Whether the grid should load property items asynchronously.

Returns

boolean

True when async loading is used.

Inherited from

DataGrid.useAsync


useIdPrefix()

protected useIdPrefix(): IdPrefixType

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

Returns an id prefix helper for resolving child element ids.

Returns

IdPrefixType

An IdPrefixType proxy for this widget's id prefix.

Inherited from

DataGrid.useIdPrefix


useLayoutTimer()

protected useLayoutTimer(): boolean

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

Whether the grid should use the layout timer for responsive resizing.

Returns

boolean

True when the layout timer is used.

Inherited from

DataGrid.useLayoutTimer


usePager()

protected usePager(): boolean

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

Whether the grid should render a pager.

Returns

boolean

True when paging is enabled.

Inherited from

DataGrid.usePager


viewDataChanged()

protected viewDataChanged(): void

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

Handles view data changes by notifying subscribers and relaying out.

Returns

void

Inherited from

DataGrid.viewDataChanged


protected wrapFormatterWithEditLink(column, item): void

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

Wraps a column formatter with an edit link formatter.

Parameters

column

Column

Column to wrap.

item

PropertyItem

Property item describing the edit link.

Returns

void

Inherited from

DataGrid.wrapFormatterWithEditLink


create()

static create<TWidget, P>(params): TWidget

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

Creates a widget instance from the given params, appending its element to the container and invoking the init/init callbacks.

Type Parameters

TWidget

TWidget extends Widget<P>

P

P

Parameters

params

CreateWidgetParams<TWidget, P>

The widget creation params.

Returns

TWidget

The created widget instance.

Inherited from

DataGrid.create


createDefaultElement()

static createDefaultElement(): HTMLDivElement

Defined in: src/ui/editors/checktreeeditor.tsx:52

Creates the default div element for the check tree editor.

Returns

HTMLDivElement

The div element.

Overrides

DataGrid.createDefaultElement


getWidgetName()

static getWidgetName(type): string

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

Returns the widget name for a type, used for association and unique names.

Parameters

type

Function

The widget type.

Returns

string

The widget name.

Inherited from

DataGrid.getWidgetName


propertyItemToQuickFilter()

static propertyItemToQuickFilter(item): QuickFilter<any, any>

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

Converts a property item to a quick filter definition.

Parameters

item

PropertyItem

Property item to convert.

Returns

QuickFilter<any, any>

The quick filter definition, or null if not applicable.

Inherited from

DataGrid.propertyItemToQuickFilter


registerClass()

protected static registerClass<TypeName>(typeName, intfAndAttr?): ClassTypeInfo<TypeName>

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

Registers this type as a class with the given type name.

Type Parameters

TypeName

TypeName

Parameters

typeName

StringLiteral<TypeName>

The type name to register.

intfAndAttr?

(InterfaceType | AttributeSpecifier)[]

Optional interfaces and attributes.

Returns

ClassTypeInfo<TypeName>

The class type info.

Inherited from

DataGrid.registerClass


registerEditor()

protected static registerEditor<TypeName>(typeName, intfAndAttr?): EditorTypeInfo<TypeName>

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

Registers this type as an editor with the given type name.

Type Parameters

TypeName

TypeName

Parameters

typeName

StringLiteral<TypeName>

The type name to register.

intfAndAttr?

(InterfaceType | AttributeSpecifier)[]

Optional interfaces and attributes.

Returns

EditorTypeInfo<TypeName>

The editor type info.

Inherited from

DataGrid.registerEditor