Class TableModel

This is a default implementation of TableModelIf. Ths TableModel is on one hand a container for the header, body, and footer models (see : #getAreaModel, and #AreaModelIf), and on the other hand the master of the column information (#getColumnCount(), #getColumnWidth(columnIndex: number)).

If getFixedLeftColumnCount() returns a value greater than 0, a fixed west area will be rendered in the header, body, and footer. A value greater than 0 for getFixedLeftColumnCount() will result in the presence of an east area.

 +----------------+-------------------+--------------+
 |  header/west   |  header/center    | header/east  |
 +----------------+-------------------+--------------+
 |  body/west     |  body/center      | body/east    |
 +----------------+-------------------+--------------+
 |  footer/west   |  footer/center    | footer/east  |
 +----------------+-------------------+--------------+

Hierarchy

TableModel
- PivotTableModel
- SpreadsheetTableModel

Implements

TableModelIf

Index

Constructors

constructor

Constructors

constructor

new TableModel(headerAreaModel, bodyAreaModel, footerAreaModel, fixedLeftColumnCount?, fixedRightColumnCount?, rowCheckboxVisible?, defaultRowHeights?, columnDefs?, columnSizes?, overridingColumnWidth?, columnCount?, parentSize?, getSelectionModel?): TableModel
Parameters
- headerAreaModel: AreaModelIf
- bodyAreaModel: AreaModelIf
- footerAreaModel: AreaModelIf
- fixedLeftColumnCount: number = 0
- fixedRightColumnCount: number = 0
- rowCheckboxVisible: boolean = false
- defaultRowHeights: DefaultRowHeightsIf = ...
- columnDefs: ColumnDefIf[] = []
- columnSizes: number[] = []
- overridingColumnWidth: number = -1
- columnCount: number = 0
- parentSize: number = 400
- getSelectionModel: GetT<SelectionModelIf> = ...
Returns TableModel
- Defined in src/lib/table/data/tablemodel/table-model.ts:60

Properties

`Readonly` bodyAreaModel

bodyAreaModel: AreaModelIf

`Protected` columnCount

columnCount: number = 0

columnDefs

columnDefs: ColumnDefIf[] = []

columnSizes

columnSizes: number[] = []

`Protected` contentHeightInPx

contentHeightInPx: number = 0

`Protected` contentWidthInPx

contentWidthInPx: number = 0

`Readonly` defaultRowHeights

defaultRowHeights: DefaultRowHeightsIf = ...

`Readonly` fixedLeftColumnCount

fixedLeftColumnCount: number = 0

`Readonly` fixedRightColumnCount

fixedRightColumnCount: number = 0

`Readonly` footerAreaModel

footerAreaModel: AreaModelIf

`Protected` footerVisible

footerVisible: boolean = true

false: the footer is hidden (height 0), see setFooterVisible.

getSelectionModel

getSelectionModel: GetT<SelectionModelIf> = ...

`Readonly` headerAreaModel

headerAreaModel: AreaModelIf

`Protected` headerVisible

headerVisible: boolean = true

false: the header is hidden (height 0), see setHeaderVisible.

`Protected` overridingColumnWidth

overridingColumnWidth: number = -1

`Protected` padding

padding: Padding = ...

`Protected` parentSize

parentSize: number = 400

`Readonly` rowCheckboxVisible

rowCheckboxVisible: boolean = false

`Protected` rowCount

rowCount: number = 0

`Protected` xPositions

xPositions: number[] = []

Methods

changeColumnOrder

changeColumnOrder(sourceColumnIndex, targetColumnIndex): void
Moves a column in the column order.
Parameters
- sourceColumnIndex: number
  The index of the column to be moved.
- targetColumnIndex: number
  The index where the column should be moved to.
Returns void
Implementation of TableModelIf.changeColumnOrder
- Defined in src/lib/table/data/tablemodel/table-model.ts:616

doSort

doSort(sortItems): boolean
Sorts the items using the given sortItems array.
Parameters
- sortItems: SortItem[]
  An array of sort items to sort the items.
Returns boolean
- Returns true if the sorting is successful, otherwise false.
Implementation of TableModelIf.doSort
- Defined in src/lib/table/data/tablemodel/table-model.ts:546

externalFilterChanged

externalFilterChanged<T>(predictFn): void
This method is called when an external filter is changed.
Type Parameters
- T
Parameters
- predictFn: FilterFunction<T>
  The function used to predict whether an element should be filtered or not.
Returns void
Implementation of TableModelIf.externalFilterChanged
- Defined in src/lib/table/data/tablemodel/table-model.ts:536

getAreaHeight

getAreaHeight(areaIdent): number
Calculates the height of the area identified by the given area identifier.
Parameters
- areaIdent: AreaIdent
  The identifier of the area.
Returns number
- The height of the area.
- Defined in src/lib/table/data/tablemodel/table-model.ts:306

getAreaModel

getAreaModel(area): AreaModelIf
Retrieves the area model (header, body or footer) based on the area identification.
Parameters
- area: AreaIdent
  The identifier of the area.
Returns AreaModelIf
The area model corresponding to the given area identification.

Throws
If the area identification is invalid.
Implementation of TableModelIf.getAreaModel
- Defined in src/lib/table/data/tablemodel/table-model.ts:397

getBodyModel

getBodyModel(): AreaModelIf
Returns the body area model.

Returns AreaModelIf
The body area model.
Implementation of TableModelIf.getBodyModel
- Defined in src/lib/table/data/tablemodel/table-model.ts:415

getBodyRowByIndex

getBodyRowByIndex(rowIndex): any
Retrieves the row object from the body model at the specified index.
Parameters
- rowIndex: number
  The index of the row to retrieve.
Returns any
The row object at the specified index.
Implementation of TableModelIf.getBodyRowByIndex
- Defined in src/lib/table/data/tablemodel/table-model.ts:586

getColumnCount

getColumnCount(): number
Retrieves the count of columns in the current instance.

Returns number
The count of columns.
Implementation of TableModelIf.getColumnCount
- Defined in src/lib/table/data/tablemodel/table-model.ts:123

getColumnDef

getColumnDef(index): undefined | ColumnDefIf
Returns the column definition at the specified index.
Parameters
- index: number
  The index of the column definition to retrieve.
Returns undefined | ColumnDefIf
- The column definition at the specified index, or undefined if no ColumnDef is specified for the given column
Implementation of TableModelIf.getColumnDef
- Defined in src/lib/table/data/tablemodel/table-model.ts:365

getColumnDefs

getColumnDefs(): undefined | ColumnDefIf[]
Returns an array of ColumnDefIf objects or undefined.

Returns undefined | ColumnDefIf[]
An array of ColumnDefIf objects or undefined.
Implementation of TableModelIf.getColumnDefs
- Defined in src/lib/table/data/tablemodel/table-model.ts:561

getColumnProperty

getColumnProperty(columnIndex): string
Retrieves the property key of the table row business object associated with the specified column index. It's only available when columnDefs are specified.
Parameters
- columnIndex: number
  The index of the column to retrieve the property from.
Returns string
The property associated with the specified column index.
Implementation of TableModelIf.getColumnProperty
- Defined in src/lib/table/data/tablemodel/table-model.ts:572

getColumnWidth

getColumnWidth(columnIndex): number
Retrieves the width of a column specified by its index.
Parameters
- columnIndex: number
  The index of the desired column.
Returns number
- The width of the specified column.
Implementation of TableModelIf.getColumnWidth
- Defined in src/lib/table/data/tablemodel/table-model.ts:163

getContentHeightInPixel

getContentHeightInPixel(): number
Returns the height of the content in pixels.

Returns number
The height of the content in pixels.
Implementation of TableModelIf.getContentHeightInPixel
- Defined in src/lib/table/data/tablemodel/table-model.ts:266

getContentWidthInPixel

getContentWidthInPixel(): number
Returns the width of the content in pixels.

Returns number
The width of the content in pixels.
Implementation of TableModelIf.getContentWidthInPixel
- Defined in src/lib/table/data/tablemodel/table-model.ts:275

getFixedLeftColumnCount

getFixedLeftColumnCount(): number
Retrieves the count of fixed left columns.

Returns number
The count of fixed left columns.
Implementation of TableModelIf.getFixedLeftColumnCount
- Defined in src/lib/table/data/tablemodel/table-model.ts:377

getFixedRightColumnCount

getFixedRightColumnCount(): number
Returns the number of fixed right columns.

Returns number
The number of fixed right columns.
Implementation of TableModelIf.getFixedRightColumnCount
- Defined in src/lib/table/data/tablemodel/table-model.ts:386

getModel

getModel(rowAreaIdent): AreaModelIf
Retrieves the model for the given row area identifier.
Parameters
- rowAreaIdent: AreaIdent
  The identifier of the row area.
Returns AreaModelIf
- The model of the specified row area.
- Defined in src/lib/table/data/tablemodel/table-model.ts:296

getPadding

getPadding(): Padding
Retrieves the padding value.

Returns Padding
The padding value.
Implementation of TableModelIf.getPadding
- Defined in src/lib/table/data/tablemodel/table-model.ts:257

getRowHeight

getRowHeight(rowAreaIdent, rowIndex): number
Returns the height of the specified row in the given row area identifier.
Parameters
- rowAreaIdent: AreaIdent
  The row area identifier.
- rowIndex: number
  The index of the row.
Returns number
- The height of the specified row.
Implementation of TableModelIf.getRowHeight
- Defined in src/lib/table/data/tablemodel/table-model.ts:286

getSideAreaWidth

getSideAreaWidth(sideIdent): number
Returns the total width of the side area identified by sideIdent.
Parameters
- sideIdent: SideIdent
  The identifier of the side area ("west" | "center" | "east").
Returns number
- The total width in pixels of the side area.
- Defined in src/lib/table/data/tablemodel/table-model.ts:326

getSideStartAndEndColumnIndex

getSideStartAndEndColumnIndex(sideIdent): [number, number]
Retrieves the start and end column indices based on the given side identifier.
Parameters
- sideIdent: SideIdent
  The side identifier, which can be "west", "east", or "center".
Returns [number, number]
- An array containing the start and end column indices.
- Defined in src/lib/table/data/tablemodel/table-model.ts:341

getTableScope

getTableScope(): undefined | TableScope
Returns undefined | TableScope
Implementation of TableModelIf.getTableScope
- Defined in src/lib/table/data/tablemodel/table-model.ts:725

getXPosByColumnIndex

getXPosByColumnIndex(columnIndex): number
Retrieves the x position for a given column index.
Parameters
- columnIndex: number
  The index of the column.
Returns number
- The x position of the column.
Implementation of TableModelIf.getXPosByColumnIndex
- Defined in src/lib/table/data/tablemodel/table-model.ts:183

init

init(): void
Triggered by TableScope.firstInit() after the table tag is attached to the dom.

Returns void
Implementation of TableModelIf.init
- Defined in src/lib/table/data/tablemodel/table-model.ts:98

isColumnVisible

isColumnVisible(column): boolean
Whether a column is shown (ColumnDefIf.isVisible). Columns without a column definition are always shown.
Parameters
- column: string | number | ColumnDefIf
  column index, property or column definition
Returns boolean
false for hidden and for unknown columns
Example
```
const hidden = tableModel.isColumnVisible?.("category") === false;
```
Implementation of TableModelIf.isColumnVisible
- Defined in src/lib/table/data/tablemodel/table-model.ts:513

isFooterVisibe

isFooterVisibe(): boolean
Checks if the footer is visible: it has rows and is not hidden with setFooterVisible.

Returns boolean
True if the footer is visible, false otherwise.
Implementation of TableModelIf.isFooterVisibe
- Defined in src/lib/table/data/tablemodel/table-model.ts:424

isHeaderVisibe

isHeaderVisibe(): boolean
Checks if the header area is visible: it has rows and is not hidden with setHeaderVisible.

Returns boolean
Returns true if the header area is visible, otherwise false.
Implementation of TableModelIf.isHeaderVisibe
- Defined in src/lib/table/data/tablemodel/table-model.ts:432

isRowCheckboxVisible

isRowCheckboxVisible(): boolean
Checks whether the row checkbox is visible.

Returns boolean
True if the row checkbox is visible, otherwise false.
Implementation of TableModelIf.isRowCheckboxVisible
- Defined in src/lib/table/data/tablemodel/table-model.ts:526

isSortable

isSortable(columnIndex): boolean
Checks if a column at the given index is sortable.
Parameters
- columnIndex: number
  The index of the column to check.
Returns boolean
- true if the column is sortable, false otherwise.
Implementation of TableModelIf.isSortable
- Defined in src/lib/table/data/tablemodel/table-model.ts:597

recalcHeightAndPadding

recalcHeightAndPadding(): void
Recalculates the height and padding for the body area.

This method retrieves the area model for the "body" area, and updates the rowCount property with the row count of the model.

The contentHeightInPx property is then updated with the height of the "body" area.

The method calls the recalcContentWidthInPx() method to recalculate the content width.

Finally, the method calls the recalcPadding() method to recalculate the padding.

Returns void
Implementation of TableModelIf.recalcHeightAndPadding
- Defined in src/lib/table/data/tablemodel/table-model.ts:222

recalcPadding

recalcPadding(): void
Recalculates the padding of an element based on the width and height of its surrounding areas.

Returns void
Method
recalcPadding
Implementation of TableModelIf.recalcPadding
- Defined in src/lib/table/data/tablemodel/table-model.ts:238

recalcSize

recalcSize(clientWidth): void
Recalculates the size (width, height, padding) of the elements based on the client width.
Parameters
- clientWidth: number
  The width of the client area.
Returns void
- This method does not return a value.
Implementation of TableModelIf.recalcSize
- Defined in src/lib/table/data/tablemodel/table-model.ts:200

setColumnVisible

setColumnVisible(column, visible): boolean
Shows or hides a column. The column keeps its definition, position and width – a hidden column has the width 0 (getColumnWidth), is not rendered, copied or exported; showing it again restores its width.

Works through ColumnDefIf.isVisible: it is replaced by TrueFn / FalseFn (an own isVisible function of the column is replaced, too). Columns without a column definition can't be hidden. With header groups (AreaModelCellGroups) the column is shown only if neither this method nor a collapsed group hides it – expanding the group does not bring back a column hidden here, and vice versa. Weight widths (new Size(1, "weight")) are shared among the shown columns. Recalculates the content width, the padding (fixed columns) and the x positions. Only changes the model – TableApi.setColumnVisible also repaints the table.
Parameters
- column: string | number | ColumnDefIf
  column index (fixed columns included), property or column definition
- visible: boolean
  false hides the column
Returns boolean
false if there is no such column definition
Example
```
tableModel.setColumnVisible?.("category", false);
```
Implementation of TableModelIf.setColumnVisible
- Defined in src/lib/table/data/tablemodel/table-model.ts:484

setColumnWidth

setColumnWidth(columnIndex, width): void
Sets the width in pixel of a column (by columnIndex) in a table. The width is also stored in the column's ColumnDef (width = the new px size), so it survives a host resize (the widths are recalculated from the ColumnDefs then).
Parameters
- columnIndex: number
  The index of the column.
- width: number
  The desired width of the column.
Returns void
Implementation of TableModelIf.setColumnWidth
- Defined in src/lib/table/data/tablemodel/table-model.ts:136

setFooterVisible

setFooterVisible(visible): void
Shows or hides the footer. A hidden footer takes no space; its area model and rows stay unchanged. Only changes the model – TableApi.setFooterVisible also repaints the table.
Parameters
- visible: boolean
  false hides the footer
Returns void
Example
```
tableModel.setFooterVisible?.(false);
```
Implementation of TableModelIf.setFooterVisible
- Defined in src/lib/table/data/tablemodel/table-model.ts:460

setHeaderVisible

setHeaderVisible(visible): void
Shows or hides the header. A hidden header takes no space (the body moves up); its area model and rows stay unchanged, so showing it again restores it. Only changes the model – TableApi.setHeaderVisible also repaints the table.
Parameters
- visible: boolean
  false hides the header
Returns void
Example
```
tableModel.setHeaderVisible?.(false);
```
Implementation of TableModelIf.setHeaderVisible
- Defined in src/lib/table/data/tablemodel/table-model.ts:446

setParentWidth

setParentWidth(widthInPixel): void
Recalculates the column widths of the table.
Parameters
- widthInPixel: number
Returns void
Implementation of TableModelIf.setParentWidth
- Defined in src/lib/table/data/tablemodel/table-model.ts:114

setTableScope

setTableScope(tableScope): void
Parameters
- tableScope: TableScope
Returns void
Implementation of TableModelIf.setTableScope
- Defined in src/lib/table/data/tablemodel/table-model.ts:722

sort

sort(compareFn): void
Parameters
- compareFn: ((a, b) => number)
  - - (a, b): number
    - Parameters
      a: any
      b: any
      Returns number
Returns void
Implementation of TableModelIf.sort
- Defined in src/lib/table/data/tablemodel/table-model.ts:551

Class TableModel

Hierarchy

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

headerAreaModel: AreaModelIf

bodyAreaModel: AreaModelIf

footerAreaModel: AreaModelIf

fixedLeftColumnCount: number = 0

fixedRightColumnCount: number = 0

rowCheckboxVisible: boolean = false

defaultRowHeights: DefaultRowHeightsIf = ...

columnDefs: ColumnDefIf[] = []

columnSizes: number[] = []

overridingColumnWidth: number = -1

columnCount: number = 0

parentSize: number = 400

getSelectionModel: GetT<SelectionModelIf> = ...

Returns TableModel

Properties

Readonly bodyAreaModel

Protected columnCount

columnDefs

columnSizes

Protected contentHeightInPx

Protected contentWidthInPx

Readonly defaultRowHeights

Readonly fixedLeftColumnCount

Readonly fixedRightColumnCount

Readonly footerAreaModel

Protected footerVisible

getSelectionModel

Readonly headerAreaModel

Protected headerVisible

Protected overridingColumnWidth

Protected padding

Protected parentSize

Readonly rowCheckboxVisible

Protected rowCount

Protected xPositions

Methods

changeColumnOrder

Parameters

sourceColumnIndex: number

targetColumnIndex: number

Returns void

doSort

Parameters

sortItems: SortItem[]

Returns boolean

externalFilterChanged

Type Parameters

T

Parameters

predictFn: FilterFunction<T>

Returns void

getAreaHeight

Parameters

areaIdent: AreaIdent

Returns number

getAreaModel

Parameters

area: AreaIdent

Returns AreaModelIf

Throws

getBodyModel

Returns AreaModelIf

getBodyRowByIndex

Parameters

rowIndex: number

Returns any

getColumnCount

Returns number

getColumnDef

Parameters

`Readonly` bodyAreaModel

`Protected` columnCount

`Protected` contentHeightInPx

`Protected` contentWidthInPx

`Readonly` defaultRowHeights

`Readonly` fixedLeftColumnCount

`Readonly` fixedRightColumnCount

`Readonly` footerAreaModel

`Protected` footerVisible

`Readonly` headerAreaModel

`Protected` headerVisible

`Protected` overridingColumnWidth

`Protected` padding

`Protected` parentSize

`Readonly` rowCheckboxVisible

`Protected` rowCount

`Protected` xPositions