行选择 API

状态

行选择状态存储在表格上，使用以下形状

tsx

export type RowSelectionState = Record<string, boolean>

export type RowSelectionTableState = {
  rowSelection: RowSelectionState
}

export type RowSelectionState = Record<string, boolean>

export type RowSelectionTableState = {
  rowSelection: RowSelectionState
}

默认情况下，行选择状态使用每行的索引作为行标识符。通过传入自定义的 getRowId 函数到表格，可以使用自定义的唯一行 ID 来跟踪行选择状态。

表格选项

enableRowSelection

tsx

enableRowSelection?: boolean | ((row: Row<TData>) => boolean)

enableRowSelection?: boolean | ((row: Row<TData>) => boolean)

启用/禁用表格中所有行的行选择，或者
一个函数，给定一行，返回是否启用/禁用该行的行选择

enableMultiRowSelection

tsx

enableMultiRowSelection?: boolean | ((row: Row<TData>) => boolean)

enableMultiRowSelection?: boolean | ((row: Row<TData>) => boolean)

启用/禁用表格中所有行的多行选择，或者
一个函数，给定一行，返回是否启用/禁用该行的子行/孙子行的多行选择

enableSubRowSelection

tsx

enableSubRowSelection?: boolean | ((row: Row<TData>) => boolean)

enableSubRowSelection?: boolean | ((row: Row<TData>) => boolean)

当父行被选中时，启用/禁用自动子行选择；或者一个函数，为每一行启用/禁用自动子行选择。

（与展开或分组功能结合使用）

onRowSelectionChange

tsx

onRowSelectionChange?: OnChangeFn<RowSelectionState>

onRowSelectionChange?: OnChangeFn<RowSelectionState>

如果提供此函数，则当 state.rowSelection 更改时，将使用 updaterFn 调用此函数。这将覆盖默认的内部状态管理，因此您需要完全或部分地在表格外部持久化状态更改。

表格 API

getToggleAllRowsSelectedHandler

tsx

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

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

返回一个处理程序，可用于切换表格中的所有行。

getToggleAllPageRowsSelectedHandler

tsx

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

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

返回一个处理程序，可用于切换当前页面上的所有行。

setRowSelection

tsx

setRowSelection: (updater: Updater<RowSelectionState>) => void

setRowSelection: (updater: Updater<RowSelectionState>) => void

设置或更新 state.rowSelection 状态。

resetRowSelection

tsx

resetRowSelection: (defaultState?: boolean) => void

resetRowSelection: (defaultState?: boolean) => void

将 rowSelection 状态重置为 initialState.rowSelection，或者可以传递 true 以强制默认空白状态重置为 {}。

getIsAllRowsSelected

tsx

getIsAllRowsSelected: () => boolean

getIsAllRowsSelected: () => boolean

返回表格中的所有行是否都被选中。

getIsAllPageRowsSelected

tsx

getIsAllPageRowsSelected: () => boolean

getIsAllPageRowsSelected: () => boolean

返回当前页面上的所有行是否都被选中。

getIsSomeRowsSelected

tsx

getIsSomeRowsSelected: () => boolean

getIsSomeRowsSelected: () => boolean

返回表格中是否有任何行被选中。

注意：如果所有行都被选中，则返回 false。

getIsSomePageRowsSelected

tsx

getIsSomePageRowsSelected: () => boolean

getIsSomePageRowsSelected: () => boolean

返回当前页面上是否有任何行被选中。

toggleAllRowsSelected

tsx

toggleAllRowsSelected: (value: boolean) => void

toggleAllRowsSelected: (value: boolean) => void

选择/取消选择表格中的所有行。

toggleAllPageRowsSelected

tsx

toggleAllPageRowsSelected: (value: boolean) => void

toggleAllPageRowsSelected: (value: boolean) => void

选择/取消选择当前页面上的所有行。

getPreSelectedRowModel

tsx

getPreSelectedRowModel: () => RowModel<TData>

getPreSelectedRowModel: () => RowModel<TData>

getSelectedRowModel

tsx

getSelectedRowModel: () => RowModel<TData>

getSelectedRowModel: () => RowModel<TData>

getFilteredSelectedRowModel

tsx

getFilteredSelectedRowModel: () => RowModel<TData>

getFilteredSelectedRowModel: () => RowModel<TData>

getGroupedSelectedRowModel

tsx

getGroupedSelectedRowModel: () => RowModel<TData>

getGroupedSelectedRowModel: () => RowModel<TData>

行 API

getIsSelected

tsx

getIsSelected: () => boolean

getIsSelected: () => boolean

返回该行是否被选中。

getIsSomeSelected

tsx

getIsSomeSelected: () => boolean

getIsSomeSelected: () => boolean

返回该行的某些子行是否被选中。

getIsAllSubRowsSelected

tsx

getIsAllSubRowsSelected: () => boolean

getIsAllSubRowsSelected: () => boolean

返回该行的所有子行是否都被选中。

getCanSelect

tsx

getCanSelect: () => boolean

getCanSelect: () => boolean

返回该行是否可以被选中。

getCanMultiSelect

tsx

getCanMultiSelect: () => boolean

getCanMultiSelect: () => boolean

返回该行是否可以多选。

getCanSelectSubRows

tsx

getCanSelectSubRows: () => boolean

getCanSelectSubRows: () => boolean

返回当父行被选中时，该行是否可以自动选择子行。

toggleSelected

tsx

toggleSelected: (value?: boolean) => void

toggleSelected: (value?: boolean) => void

选择/取消选择该行。

getToggleSelectedHandler

tsx

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

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

返回一个处理程序，可用于切换该行。

状态