Skip to content

@serenity-is/sleekgrid / Grid

Class: Grid<TItem>

Type parameters

Name Type
TItem any

Implements

Table of contents

Constructors

Properties

Methods

Constructors

constructor

• new Grid<TItem>(container, data, columns, options): Grid<TItem>

Type parameters

Name Type
TItem any

Parameters

Name Type
container HTMLElement | ArrayLike<HTMLElement>
data any
columns Column<TItem>[]
options GridOptions<TItem>

Returns

Grid<TItem>

Defined in

grid/grid.ts:124

Properties

onActiveCellChanged

• Readonly onActiveCellChanged: EventEmitter<ArgsCell, IEventData>

Defined in

grid/grid.ts:87


onActiveCellPositionChanged

• Readonly onActiveCellPositionChanged: EventEmitter<ArgsGrid, IEventData>

Defined in

grid/grid.ts:88


onAddNewRow

• Readonly onAddNewRow: EventEmitter<ArgsAddNewRow, IEventData>

Defined in

grid/grid.ts:89


onBeforeCellEditorDestroy

• Readonly onBeforeCellEditorDestroy: EventEmitter<ArgsEditorDestroy, IEventData>

Defined in

grid/grid.ts:90


onBeforeDestroy

• Readonly onBeforeDestroy: EventEmitter<ArgsGrid, IEventData>

Defined in

grid/grid.ts:91


onBeforeEditCell

• Readonly onBeforeEditCell: EventEmitter<ArgsCellEdit, IEventData>

Defined in

grid/grid.ts:92


onBeforeFooterRowCellDestroy

• Readonly onBeforeFooterRowCellDestroy: EventEmitter<ArgsColumnNode, IEventData>

Defined in

grid/grid.ts:93


onBeforeHeaderCellDestroy

• Readonly onBeforeHeaderCellDestroy: EventEmitter<ArgsColumnNode, IEventData>

Defined in

grid/grid.ts:94


onBeforeHeaderRowCellDestroy

• Readonly onBeforeHeaderRowCellDestroy: EventEmitter<ArgsColumnNode, IEventData>

Defined in

grid/grid.ts:95


onCellChange

• Readonly onCellChange: EventEmitter<ArgsCellChange, IEventData>

Defined in

grid/grid.ts:96


onCellCssStylesChanged

• Readonly onCellCssStylesChanged: EventEmitter<ArgsCssStyle, IEventData>

Defined in

grid/grid.ts:97


onClick

• Readonly onClick: EventEmitter<ArgsCell, MouseEvent>

Defined in

grid/grid.ts:98


onColumnsReordered

• Readonly onColumnsReordered: EventEmitter<ArgsGrid, IEventData>

Defined in

grid/grid.ts:99


onColumnsResized

• Readonly onColumnsResized: EventEmitter<ArgsGrid, IEventData>

Defined in

grid/grid.ts:100


onCompositeEditorChange

• Readonly onCompositeEditorChange: EventEmitter<ArgsGrid, IEventData>

Implementation of

EditorHost.onCompositeEditorChange

Defined in

grid/grid.ts:101


onContextMenu

• Readonly onContextMenu: EventEmitter<ArgsGrid, UIEvent>

Defined in

grid/grid.ts:102


onDblClick

• Readonly onDblClick: EventEmitter<ArgsCell, MouseEvent>

Defined in

grid/grid.ts:103


onDrag

• Readonly onDrag: EventEmitter<ArgsGrid, UIEvent>

Defined in

grid/grid.ts:104


onDragEnd

• Readonly onDragEnd: EventEmitter<ArgsGrid, UIEvent>

Defined in

grid/grid.ts:105


onDragInit

• Readonly onDragInit: EventEmitter<ArgsGrid, UIEvent>

Defined in

grid/grid.ts:106


onDragStart

• Readonly onDragStart: EventEmitter<ArgsGrid, UIEvent>

Defined in

grid/grid.ts:107


onFooterRowCellRendered

• Readonly onFooterRowCellRendered: EventEmitter<ArgsColumnNode, IEventData>

Defined in

grid/grid.ts:108


onHeaderCellRendered

• Readonly onHeaderCellRendered: EventEmitter<ArgsColumnNode, IEventData>

Defined in

grid/grid.ts:109


onHeaderClick

• Readonly onHeaderClick: EventEmitter<ArgsColumn, IEventData>

Defined in

grid/grid.ts:110


onHeaderContextMenu

• Readonly onHeaderContextMenu: EventEmitter<ArgsColumn, IEventData>

Defined in

grid/grid.ts:111


onHeaderMouseEnter

• Readonly onHeaderMouseEnter: EventEmitter<ArgsColumn, MouseEvent>

Defined in

grid/grid.ts:112


onHeaderMouseLeave

• Readonly onHeaderMouseLeave: EventEmitter<ArgsColumn, MouseEvent>

Defined in

grid/grid.ts:113


onHeaderRowCellRendered

• Readonly onHeaderRowCellRendered: EventEmitter<ArgsColumnNode, IEventData>

Defined in

grid/grid.ts:114


onKeyDown

• Readonly onKeyDown: EventEmitter<ArgsCell, KeyboardEvent>

Defined in

grid/grid.ts:115


onMouseEnter

• Readonly onMouseEnter: EventEmitter<ArgsGrid, MouseEvent>

Defined in

grid/grid.ts:116


onMouseLeave

• Readonly onMouseLeave: EventEmitter<ArgsGrid, MouseEvent>

Defined in

grid/grid.ts:117


onScroll

• Readonly onScroll: EventEmitter<ArgsScroll, IEventData>

Defined in

grid/grid.ts:118


onSelectedRowsChanged

• Readonly onSelectedRowsChanged: EventEmitter<ArgsSelectedRowsChange, IEventData>

Defined in

grid/grid.ts:119


onSort

• Readonly onSort: EventEmitter<ArgsSort, IEventData>

Defined in

grid/grid.ts:120


onValidationError

• Readonly onValidationError: EventEmitter<ArgsValidationError, IEventData>

Defined in

grid/grid.ts:121


onViewportChanged

• Readonly onViewportChanged: EventEmitter<ArgsGrid, IEventData>

Defined in

grid/grid.ts:122

Methods

addCellCssStyles

▸ addCellCssStyles(key, hash): void

Parameters

Name Type
key string
hash CellStylesHash

Returns

void

Defined in

grid/grid.ts:2840


autosizeColumns

▸ autosizeColumns(): void

Returns

void

Defined in

grid/grid.ts:1252


canCellBeActive

▸ canCellBeActive(row, cell): boolean

Parameters

Name Type
row number
cell number

Returns

boolean

Defined in

grid/grid.ts:3796


canCellBeSelected

▸ canCellBeSelected(row, cell): any

Parameters

Name Type
row number
cell number

Returns

any

Defined in

grid/grid.ts:3819


clearTextSelection

▸ clearTextSelection(): void

Returns

void

Defined in

grid/grid.ts:3350


columnsResized

▸ columnsResized(invalidate?): void

Parameters

Name Type Default value
invalidate boolean true

Returns

void

Defined in

grid/grid.ts:1037


commitCurrentEdit

▸ commitCurrentEdit(): boolean

Returns

boolean

Defined in

grid/grid.ts:3864


destroy

▸ destroy(): void

Returns

void

Defined in

grid/grid.ts:1174


editActiveCell

▸ editActiveCell(editor?): void

Parameters

Name Type
editor? EditorClass

Returns

void

Defined in

grid/grid.ts:3407


flashCell

▸ flashCell(row, cell, speed?): void

Parameters

Name Type
row number
cell number
speed? number

Returns

void

Defined in

grid/grid.ts:2875


focus

▸ focus(): void

Returns

void

Defined in

grid/grid.ts:3244


getAbsoluteColumnMinWidth

▸ getAbsoluteColumnMinWidth(): number

Returns

number

Defined in

grid/grid.ts:452


getActiveCanvasNode

▸ getActiveCanvasNode(e?): HTMLElement

Parameters

Name Type
e? IEventData

Returns

HTMLElement

Defined in

grid/grid.ts:479


getActiveCell

▸ getActiveCell(): RowCell

Returns

RowCell

Implementation of

EditorHost.getActiveCell

Defined in

grid/grid.ts:3528


getActiveCellNode

▸ getActiveCellNode(): HTMLElement

Returns

HTMLElement

Defined in

grid/grid.ts:3536


getActiveViewportNode

▸ getActiveViewportNode(e?): HTMLElement

Parameters

Name Type
e? IEventData

Returns

HTMLElement

Defined in

grid/grid.ts:494


getCanvasNode

▸ getCanvasNode(columnIdOrIdx?, row?): HTMLElement

Parameters

Name Type
columnIdOrIdx? string | number
row? number

Returns

HTMLElement

Defined in

grid/grid.ts:470


getCanvases

▸ getCanvases(): any

Returns

any

Defined in

grid/grid.ts:474


getCellCssStyles

▸ getCellCssStyles(key): CellStylesHash

Parameters

Name Type
key string

Returns

CellStylesHash

Defined in

grid/grid.ts:2871


getCellEditor

▸ getCellEditor(): Editor

Returns

Editor

Defined in

grid/grid.ts:3524


getCellFromEvent

▸ getCellFromEvent(e): Object

Parameters

Name Type
e any

Returns

Object

Name Type
cell number
row number

Defined in

grid/grid.ts:3186


getCellFromNode

▸ getCellFromNode(cellNode): number

Parameters

Name Type
cellNode Element

Returns

number

Defined in

grid/grid.ts:3148


getCellFromPoint

▸ getCellFromPoint(x, y): Object

Parameters

Name Type
x number
y number

Returns

Object

Name Type
cell number
row number

Defined in

grid/grid.ts:3131


getCellNode

▸ getCellNode(row, cell): HTMLElement

Parameters

Name Type
row number
cell number

Returns

HTMLElement

Defined in

grid/grid.ts:3761


getCellNodeBox

▸ getCellNodeBox(row, cell): Object

Parameters

Name Type
row number
cell number

Returns

Object

Name Type
bottom number
left number
right number
top number

Defined in

grid/grid.ts:3206


getColspan

▸ getColspan(row, cell): number

Parameters

Name Type
row number
cell number

Returns

number

Defined in

grid/grid.ts:3660


getColumnById

▸ getColumnById(id): Column<TItem>

Gets a column by its ID. May also return non visible columns

Parameters

Name Type
id string

Returns

Column<TItem>

Defined in

grid/grid.ts:1233


getColumnFromNode

▸ getColumnFromNode(cellNode): Column<TItem>

Parameters

Name Type
cellNode Element

Returns

Column<TItem>

Defined in

grid/grid.ts:3164


getColumnIndex

▸ getColumnIndex(id): number

Returns a column's index in the visible columns list by its column ID

Parameters

Name Type
id string

Returns

number

Defined in

grid/grid.ts:1238


getColumns

▸ getColumns(): Column<TItem>[]

Returns only the visible columns in order

Returns

Column<TItem>[]

Defined in

grid/grid.ts:1370


getContainerNode

▸ getContainerNode(): HTMLElement

Returns

HTMLElement

Defined in

grid/grid.ts:1664


getData

▸ getData(): any

Returns

any

Defined in

grid/grid.ts:1555


getDataItem

▸ getDataItem(i): TItem

Parameters

Name Type
i number

Returns

TItem

Defined in

grid/grid.ts:1572


getDataItemValueForColumn

▸ getDataItemValueForColumn(item, columnDef): any

Parameters

Name Type
item TItem
columnDef Column<TItem>

Returns

any

Defined in

grid/grid.ts:1797


getDataLength

▸ getDataLength(): number

Returns

number

Defined in

grid/grid.ts:1559


getDisplayedScrollbarDimensions

▸ getDisplayedScrollbarDimensions(): Object

Returns

Object

Name Type
height number
width number

Defined in

grid/grid.ts:445


getEditController

▸ getEditController(): EditController

Returns

EditController

Defined in

grid/grid.ts:1228


getEditorLock

▸ getEditorLock(): EditorLock

Returns

EditorLock

Defined in

grid/grid.ts:1224


getFooterRow

▸ getFooterRow(): HTMLElement

Returns

HTMLElement

Defined in

grid/grid.ts:598


getFooterRowColumn

▸ getFooterRowColumn(columnIdOrIdx): HTMLElement

Parameters

Name Type
columnIdOrIdx string | number

Returns

HTMLElement

Defined in

grid/grid.ts:602


getFormatter

▸ getFormatter(row, column): ColumnFormat<TItem>

Parameters

Name Type
row number
column Column<TItem>

Returns

ColumnFormat<TItem>

Defined in

grid/grid.ts:1712


getFormatterContext

▸ getFormatterContext(row, cell): FormatterContext<any>

Parameters

Name Type
row number
cell number

Returns

FormatterContext<any>

Defined in

grid/grid.ts:1766


getGridPosition

▸ getGridPosition(): Position

Returns

Position

Defined in

grid/grid.ts:3497


getGroupingPanel

▸ getGroupingPanel(): HTMLElement

Returns

HTMLElement

Defined in

grid/grid.ts:578


getHeader

▸ getHeader(): HTMLElement

Returns

HTMLElement

Defined in

grid/grid.ts:566


getHeaderColumn

▸ getHeaderColumn(columnIdOrIdx): HTMLElement

Parameters

Name Type
columnIdOrIdx string | number

Returns

HTMLElement

Defined in

grid/grid.ts:570


getHeaderRow

▸ getHeaderRow(): HTMLElement

Returns

HTMLElement

Defined in

grid/grid.ts:586


getHeaderRowColumn

▸ getHeaderRowColumn(columnIdOrIdx): HTMLElement

Parameters

Name Type
columnIdOrIdx string | number

Returns

HTMLElement

Defined in

grid/grid.ts:590


getInitialColumnIndex

▸ getInitialColumnIndex(id): number

Gets index of a column in the initial column list passed to the grid, or setColumns method. May include invisible cols and index does not have to match visible column order.

Parameters

Name Type
id string

Returns

number

Defined in

grid/grid.ts:1243


getInitialColumns

▸ getInitialColumns(): Column<TItem>[]

Returns list of columns passed to the grid constructor, or setColumns method. May include invisible columns and order does not match visible column order.

Returns

Column<TItem>[]

Defined in

grid/grid.ts:1375


getOptions

▸ getOptions(): GridOptions<TItem>

Returns

GridOptions<TItem>

Defined in

grid/grid.ts:1465


getPluginByName

▸ getPluginByName(name): IPlugin

Parameters

Name Type
name string

Returns

IPlugin

Defined in

grid/grid.ts:416


getPreHeaderPanel

▸ getPreHeaderPanel(): HTMLElement

Returns

HTMLElement

Defined in

grid/grid.ts:582


getRenderedRange

▸ getRenderedRange(viewportTop?, viewportLeft?): ViewRange

Parameters

Name Type
viewportTop? number
viewportLeft? number

Returns

ViewRange

Defined in

grid/grid.ts:2271


getRowFromNode

▸ getRowFromNode(rowNode): number

Parameters

Name Type
rowNode Element

Returns

number

Defined in

grid/grid.ts:3175


getScrollBarDimensions

▸ getScrollBarDimensions(): Object

Returns

Object

Name Type
height number
width number

Defined in

grid/grid.ts:441


getSelectedRows

▸ getSelectedRows(): number[]

Returns

number[]

Defined in

grid/grid.ts:3957


getSelectionModel

▸ getSelectionModel(): SelectionModel

Returns

SelectionModel

Defined in

grid/grid.ts:456


getSortColumns

▸ getSortColumns(): ColumnSort[]

Returns

ColumnSort[]

Defined in

grid/grid.ts:1314


getTopPanel

▸ getTopPanel(): HTMLElement

Returns

HTMLElement

Defined in

grid/grid.ts:1580


getUID

▸ getUID(): string

Returns

string

Defined in

grid/grid.ts:1668


getViewport

▸ getViewport(viewportTop?, viewportLeft?): ViewRange

Parameters

Name Type Description
viewportTop? number optional viewport top
viewportLeft? number optional viewport left

Returns

ViewRange

viewport range

Defined in

grid/grid.ts:2249


getViewportNode

▸ getViewportNode(columnIdOrIdx?, row?): HTMLElement

Parameters

Name Type
columnIdOrIdx? string | number
row? number

Returns

HTMLElement

Defined in

grid/grid.ts:486


getVisibleColumnById

▸ getVisibleColumnById(id): Column<TItem>

Gets a view (e.g. visible) column by its column ID

Parameters

Name Type
id string

Returns

Column<TItem>

Defined in

grid/grid.ts:1248


getVisibleRange

▸ getVisibleRange(viewportTop?, viewportLeft?): ViewRange

Parameters

Name Type
viewportTop? number
viewportLeft? number

Returns

ViewRange

Defined in

grid/grid.ts:2253


gotoCell

▸ gotoCell(row, cell, forceEdit?): void

Parameters

Name Type
row number
cell number
forceEdit? boolean

Returns

void

Defined in

grid/grid.ts:3838


groupTotalsFormatter

▸ groupTotalsFormatter(p1?, p2?, grid?): string

Parameters

Name Type
p1? GroupTotals<TItem>
p2? Column<TItem>
grid? any

Returns

string

Defined in

grid/grid.ts:2612


init

▸ init(): void

Returns

void

Defined in

grid/grid.ts:262


invalidate

▸ invalidate(): void

Returns

void

Defined in

grid/grid.ts:1961


invalidateAllRows

▸ invalidateAllRows(): void

Returns

void

Defined in

grid/grid.ts:1968


invalidateRow

▸ invalidateRow(row): void

Parameters

Name Type
row number

Returns

void

Defined in

grid/grid.ts:2054


invalidateRows

▸ invalidateRows(rows): void

Parameters

Name Type
rows number[]

Returns

void

Defined in

grid/grid.ts:2036


▸ navigate(dir): boolean

Parameters

Name Type Description
dir string Navigation direction.

Returns

boolean

Whether navigation resulted in a change of active cell.

Defined in

grid/grid.ts:3714


▸ navigateBottom(): void

Returns

void

Defined in

grid/grid.ts:3623


▸ navigateDown(): boolean

Returns

boolean

Defined in

grid/grid.ts:3686


▸ navigateLeft(): boolean

Returns

boolean

Defined in

grid/grid.ts:3682


▸ navigateNext(): boolean

Returns

boolean

Implementation of

EditorHost.navigateNext

Defined in

grid/grid.ts:3694


▸ navigatePageDown(): void

Returns

void

Defined in

grid/grid.ts:3611


▸ navigatePageUp(): void

Returns

void

Defined in

grid/grid.ts:3615


▸ navigatePrev(): boolean

Returns

boolean

Implementation of

EditorHost.navigatePrev

Defined in

grid/grid.ts:3698


▸ navigateRight(): boolean

Returns

boolean

Defined in

grid/grid.ts:3678


▸ navigateRowEnd(): boolean

Returns

boolean

Defined in

grid/grid.ts:3706


▸ navigateRowStart(): boolean

Returns

boolean

Defined in

grid/grid.ts:3702


▸ navigateToRow(row): boolean

Parameters

Name Type
row number

Returns

boolean

Defined in

grid/grid.ts:3627


▸ navigateTop(): void

Returns

void

Defined in

grid/grid.ts:3619


▸ navigateUp(): boolean

Returns

boolean

Defined in

grid/grid.ts:3690


registerPlugin

▸ registerPlugin(plugin): void

Parameters

Name Type
plugin IPlugin

Returns

void

Defined in

grid/grid.ts:399


removeCellCssStyles

▸ removeCellCssStyles(key): void

Parameters

Name Type
key string

Returns

void

Defined in

grid/grid.ts:2851


render

▸ render(): void

Returns

void

Defined in

grid/grid.ts:2616


resetActiveCell

▸ resetActiveCell(): void

Returns

void

Defined in

grid/grid.ts:3240


resizeCanvas

▸ resizeCanvas(): void

Returns

void

Defined in

grid/grid.ts:2133


scrollActiveCellIntoView

▸ scrollActiveCellIntoView(): void

Returns

void

Defined in

grid/grid.ts:3540


scrollCellIntoView

▸ scrollCellIntoView(row, cell, doPaging?): void

Parameters

Name Type
row number
cell number
doPaging? boolean

Returns

void

Defined in

grid/grid.ts:3256


scrollColumnIntoView

▸ scrollColumnIntoView(cell): void

Parameters

Name Type
cell number

Returns

void

Defined in

grid/grid.ts:3266


scrollRowIntoView

▸ scrollRowIntoView(row, doPaging?): void

Parameters

Name Type
row number
doPaging? boolean

Returns

void

Defined in

grid/grid.ts:3546


scrollRowToTop

▸ scrollRowToTop(row): void

Parameters

Name Type
row number

Returns

void

Defined in

grid/grid.ts:3573


setActiveCell

▸ setActiveCell(row, cell): void

Parameters

Name Type
row number
cell number

Returns

void

Defined in

grid/grid.ts:3769


setActiveRow

▸ setActiveRow(row, cell, suppressScrollIntoView?): void

Parameters

Name Type
row number
cell number
suppressScrollIntoView? boolean

Returns

void

Defined in

grid/grid.ts:3784


setCellCssStyles

▸ setCellCssStyles(key, hash): void

Parameters

Name Type
key string
hash CellStylesHash

Returns

void

Defined in

grid/grid.ts:2862


setColumnHeaderVisibility

▸ setColumnHeaderVisibility(visible, animate?): void

Parameters

Name Type
visible boolean
animate? boolean

Returns

void

Defined in

grid/grid.ts:1599


setColumns

▸ setColumns(columns): void

Parameters

Name Type
columns Column<TItem>[]

Returns

void

Defined in

grid/grid.ts:1427


setData

▸ setData(newData, scrollToTop?): void

Parameters

Name Type
newData any
scrollToTop? boolean

Returns

void

Defined in

grid/grid.ts:1544


setFooterRowVisibility

▸ setFooterRowVisibility(visible): void

Parameters

Name Type
visible boolean

Returns

void

Defined in

grid/grid.ts:1614


setGroupingPanelVisibility

▸ setGroupingPanelVisibility(visible): void

Parameters

Name Type
visible boolean

Returns

void

Defined in

grid/grid.ts:1629


setHeaderRowVisibility

▸ setHeaderRowVisibility(visible): void

Parameters

Name Type
visible boolean

Returns

void

Defined in

grid/grid.ts:1649


setOptions

▸ setOptions(args, suppressRender?, suppressColumnSet?, suppressSetOverflow?): void

Parameters

Name Type
args GridOptions<TItem>
suppressRender? boolean
suppressColumnSet? boolean
suppressSetOverflow? boolean

Returns

void

Defined in

grid/grid.ts:1469


setPreHeaderPanelVisibility

▸ setPreHeaderPanelVisibility(visible): void

Parameters

Name Type
visible boolean

Returns

void

Defined in

grid/grid.ts:1645


setSelectedRows

▸ setSelectedRows(rows): void

Parameters

Name Type
rows number[]

Returns

void

Defined in

grid/grid.ts:3964


setSelectionModel

▸ setSelectionModel(model): void

Parameters

Name Type
model SelectionModel

Returns

void

Defined in

grid/grid.ts:423


setSortColumn

▸ setSortColumn(columnId, ascending): void

Parameters

Name Type
columnId string
ascending boolean

Returns

void

Defined in

grid/grid.ts:1283


setSortColumns

▸ setSortColumns(cols): void

Parameters

Name Type
cols ColumnSort[]

Returns

void

Defined in

grid/grid.ts:1287


setTopPanelVisibility

▸ setTopPanelVisibility(visible): void

Parameters

Name Type
visible boolean

Returns

void

Defined in

grid/grid.ts:1584


unregisterPlugin

▸ unregisterPlugin(plugin): void

Parameters

Name Type
plugin IPlugin

Returns

void

Defined in

grid/grid.ts:404


updateCell

▸ updateCell(row, cell): void

Parameters

Name Type
row number
cell number

Returns

void

Defined in

grid/grid.ts:2058


updateColumnHeader

▸ updateColumnHeader(columnId, title?, toolTip?): void

Parameters

Name Type
columnId string
title? string
toolTip? string

Returns

void

Defined in

grid/grid.ts:522


updatePagingStatusFromView

▸ updatePagingStatusFromView(pagingInfo): void

Parameters

Name Type
pagingInfo Object
pagingInfo.pageNum number
pagingInfo.pageSize number
pagingInfo.totalPages number

Returns

void

Defined in

grid/grid.ts:2156


updateRow

▸ updateRow(row): void

Parameters

Name Type
row number

Returns

void

Defined in

grid/grid.ts:2080