行固定 API

行固定 API

可固定

行是否可以固定取决于以下条件

options.enableRowPinning 解析为 true
options.enablePinning 未设置为 false

状态

固定状态使用以下形状存储在表格中

tsx

export type RowPinningPosition = false | 'top' | 'bottom'

export type RowPinningState = {
  top?: string[]
  bottom?: string[]
}

export type RowPinningRowState = {
  rowPinning: RowPinningState
}

export type RowPinningPosition = false | 'top' | 'bottom'

export type RowPinningState = {
  top?: string[]
  bottom?: string[]
}

export type RowPinningRowState = {
  rowPinning: RowPinningState
}

表格选项

enableRowPinning

tsx

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

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

启用/禁用表格中所有行的行固定功能。

keepPinnedRows

tsx

keepPinnedRows?: boolean

keepPinnedRows?: boolean

当 false 时，如果固定的行被筛选或分页出表格，则它们将不可见。当 true 时，无论是否进行筛选或分页，固定的行始终可见。默认为 true。

onRowPinningChange

tsx

onRowPinningChange?: OnChangeFn<RowPinningState>

onRowPinningChange?: OnChangeFn<RowPinningState>

如果提供此函数，则当 state.rowPinning 更改时，将使用 updaterFn 调用此函数。这将覆盖默认的内部状态管理，因此您还需要从您自己的管理状态中提供 state.rowPinning。

表格 API

setRowPinning

tsx

setRowPinning: (updater: Updater<RowPinningState>) => void

setRowPinning: (updater: Updater<RowPinningState>) => void

设置或更新 state.rowPinning 状态。

resetRowPinning

tsx

resetRowPinning: (defaultState?: boolean) => void

resetRowPinning: (defaultState?: boolean) => void

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

getIsSomeRowsPinned

tsx

getIsSomeRowsPinned: (position?: RowPinningPosition) => boolean

getIsSomeRowsPinned: (position?: RowPinningPosition) => boolean

返回是否固定了任何行。可选地指定仅检查 top 或 bottom 位置的固定行。

getTopRows

tsx

getTopRows: () => Row<TData>[]

getTopRows: () => Row<TData>[]

返回所有顶部固定的行。

getBottomRows

tsx

getBottomRows: () => Row<TData>[]

getBottomRows: () => Row<TData>[]

返回所有底部固定的行。

getCenterRows

tsx

getCenterRows: () => Row<TData>[]

getCenterRows: () => Row<TData>[]

返回所有未固定在顶部或底部的行。

行 API

tsx

pin: (position: RowPinningPosition) => void

pin: (position: RowPinningPosition) => void

将行固定到 'top' 或 'bottom'，如果传递 false，则取消将行固定到中间位置。

getCanPin

tsx

getCanPin: () => boolean

getCanPin: () => boolean

返回行是否可以被固定。

getIsPinned

tsx

getIsPinned: () => RowPinningPosition

getIsPinned: () => RowPinningPosition

返回行的固定位置。 ('top'、'bottom' 或 false)

getPinnedIndex

tsx

getPinnedIndex: () => number

getPinnedIndex: () => number

返回行在固定行组内的数字固定索引。

可固定

状态