Row

The Row types are organized by feature. All feature types are ultimately joined in the single Row type definition. Below, we've separated the interfaces by feature to keep them organized.

API

CoreRow

Name & Description	Option(s)	Default
depth The depth of the row (if nested or grouped) relative to the root row array.	number
getAllCells Returns all of the cells for the row.	() => Cell< TData, unknown, ColumnMeta >[]
getLeafRows Returns the leaf rows for the row, not including any parent rows.	() => Row<TData>[]
getParentRow Returns the parent row for the row, if it exists.	() => Row<TData>
getParentRows Returns the parent rows for the row, all the way up to a root row.	() => Row<TData>[]
getUniqueValues Returns a unique array of values from the row for a given columnId.	( columnId: string, ) => Array<TValue>
getValue Returns the value from the row for a given columnId.	( columnId: string, ) => TValue
id The resolved unique identifier for the row resolved via the `options.getRowId` option. Defaults to the row's index (or relative index if it is a subRow).	string
index The index of the row within its parent array (or the root data array).	number
original The original row object provided to the table. If the row is a grouped row, the original row object will be the first original in the group.	TData
subRows An array of subRows for the row as returned and created by the `options.getSubRows` option.	Row[]
originalSubRows An array of the original subRows as returned by the `options.getSubRows` option.	Array<TData>
parentId If nested, this row's parent row id.	string

depth

Type

number

Description

The depth of the row (if nested or grouped) relative to the root row array.

getAllCells

Type

() => Cell<
  TData,
  unknown,
  ColumnMeta
>[]

Description

Returns all of the cells for the row.

getLeafRows

Type

() => Row<TData>[]

Description

Returns the leaf rows for the row, not including any parent rows.

getParentRow

Type

() => Row<TData>

Description

Returns the parent row for the row, if it exists.

getParentRows

Type

() => Row<TData>[]

Description

Returns the parent rows for the row, all the way up to a root row.

getUniqueValues

Type

(
  columnId: string,
) => Array<TValue>

Description

Returns a unique array of values from the row for a given columnId.

getValue

Type

(
  columnId: string,
) => TValue

Description

Returns the value from the row for a given columnId.

Type

string

Description

The resolved unique identifier for the row resolved via the options.getRowId option. Defaults to the row's index (or relative index if it is a subRow).

index

Type

number

Description

The index of the row within its parent array (or the root data array).

original

Type

TData

Description

The original row object provided to the table. If the row is a grouped row, the original row object will be the first original in the group.

subRows

Type

Row[]

Description

An array of subRows for the row as returned and created by the options.getSubRows option.

originalSubRows

Type

Array<TData>

Description

An array of the original subRows as returned by the options.getSubRows option.

parentId

Type

string

Description

If nested, this row's parent row id.

ColumnPinningRow

Name & Description	Option(s)	Default
getCenterVisibleCells Returns all center pinned (unpinned) leaf cells in the row.	() => Cell< TData, unknown, ColumnMeta >[]
getLeftVisibleCells Returns all left pinned leaf cells in the row.	() => Cell< TData, unknown, ColumnMeta >[]
getRightVisibleCells Returns all right pinned leaf cells in the row.	() => Cell< TData, unknown, ColumnMeta >[]

getCenterVisibleCells

Type

() => Cell<
  TData,
  unknown,
  ColumnMeta
>[]

Description

Returns all center pinned (unpinned) leaf cells in the row.

getLeftVisibleCells

Type

() => Cell<
  TData,
  unknown,
  ColumnMeta
>[]

Description

Returns all left pinned leaf cells in the row.

getRightVisibleCells

Type

() => Cell<
  TData,
  unknown,
  ColumnMeta
>[]

Description

Returns all right pinned leaf cells in the row.

FiltersRow

Name & Description	Option(s)	Default
columnFilters The column filters map for the row. This object tracks whether a row is passing/failing specific filters by their column ID.	Record< string, boolean >
columnFiltersMeta The column filters meta map for the row. This object tracks any filter meta for a row as optionally provided during the filtering process.	Record< string, Record<string, any> >

columnFilters

Type

Record<
  string,
  boolean
>

Description

The column filters map for the row. This object tracks whether a row is passing/failing specific filters by their column ID.

columnFiltersMeta

Type

Record<
  string,
  Record<string, any>
>

Description

The column filters meta map for the row. This object tracks any filter meta for a row as optionally provided during the filtering process.

GroupingRow

Name & Description	Option(s)	Default
getGroupingValue Returns the grouping value for any row and column (including leaf rows).	( columnId: string, ) => unknown
getIsGrouped Returns whether the row is currently grouped.	() => boolean
groupingColumnId If this row is grouped, this is the id of the column that this row is grouped by.	string
groupingValue If this row is grouped, this is the unique/shared value for the `groupingColumnId` for all of the rows in this group.	unknown

getGroupingValue

Type

(
  columnId: string,
) => unknown

Description

Returns the grouping value for any row and column (including leaf rows).

getIsGrouped

Type

() => boolean

Description

Returns whether the row is currently grouped.

groupingColumnId

Type

string

Description

If this row is grouped, this is the id of the column that this row is grouped by.

groupingValue

Type

unknown

Description

If this row is grouped, this is the unique/shared value for the groupingColumnId for all of the rows in this group.

RowSelectionRow

Name & Description	Option(s)	Default
getCanMultiSelect Returns whether the row can multi-select.	() => boolean
getCanSelect Returns whether the row can be selected.	() => boolean
getCanSelectSubRows Returns whether the row can select sub rows automatically when the parent row is selected.	() => boolean
getIsAllSubRowsSelected Returns whether all of the row's sub rows are selected.	() => boolean
getIsSelected Returns whether the row is selected.	() => boolean
getIsSomeSelected Returns whether some of the row's sub rows are selected.	() => boolean
getToggleSelectedHandler Returns a handler that can be used to toggle the row.	() => ( event: unknown, ) => void
toggleSelected Selects/deselects the row.	( value?: boolean, opts?: { selectChildren?: boolean }, ) => void

getCanMultiSelect

Type

() => boolean

Description

Returns whether the row can multi-select.

getCanSelect

Type

() => boolean

Description

Returns whether the row can be selected.

getCanSelectSubRows

Type

() => boolean

Description

Returns whether the row can select sub rows automatically when the parent row is selected.

getIsAllSubRowsSelected

Type

() => boolean

Description

Returns whether all of the row's sub rows are selected.

getIsSelected

Type

() => boolean

Description

Returns whether the row is selected.

getIsSomeSelected

Type

() => boolean

Description

Returns whether some of the row's sub rows are selected.

getToggleSelectedHandler

Type

() => (
  event: unknown,
) => void

Description

Returns a handler that can be used to toggle the row.

toggleSelected

Type

(
  value?: boolean,
  opts?: {
    selectChildren?: boolean
  },
) => void

Description

Selects/deselects the row.

ExpandedRow

Name & Description	Option(s)	Default
getCanExpand Returns whether the row can be expanded.	() => boolean
getIsAllParentsExpanded Returns whether all parent rows of the row are expanded.	() => boolean
getIsExpanded Returns whether the row is expanded.	() => boolean
getToggleExpandedHandler Returns a function that can be used to toggle the expanded state of the row. This function can be used to bind to an event handler to a button.	() => () => void
toggleExpanded Toggles the expanded state (or sets it if `expanded` is provided) for the row.	( expanded?: boolean, ) => void

getCanExpand

Type

() => boolean

Description

Returns whether the row can be expanded.

getIsAllParentsExpanded

Type

() => boolean

Description

Returns whether all parent rows of the row are expanded.

getIsExpanded

Type

() => boolean

Description

Returns whether the row is expanded.

getToggleExpandedHandler

Type

() => () => void

Description

Returns a function that can be used to toggle the expanded state of the row. This function can be used to bind to an event handler to a button.

toggleExpanded

Type

(
  expanded?: boolean,
) => void

Description

Toggles the expanded state (or sets it if expanded is provided) for the row.

VisibilityRow

Name & Description	Option(s)	Default
getVisibleCells Returns an array of cells that account for column visibility for the row.	() => Cell< TData, unknown, ColumnMeta >[]

getVisibleCells

Type

() => Cell<
  TData,
  unknown,
  ColumnMeta
>[]

Description

Returns an array of cells that account for column visibility for the row.

Header

QTable