用途:在 @tanstack/table-core 中实现表格分页,可选择客户端切片或服务端分页,并避免两者意外叠加。
主要能力:通过 rowPaginationFeature 与 createPaginatedRowModel 启用分页;用 pagination 状态管理 pageIndex 与 pageSize;服务端模式用 manualPagination 配合 rowCount 或 pageCount;可配置 autoResetPageIndex 控制数据变化时的页码重置策略。
基本用法:从 @tanstack/table-core 引入 createPaginatedRowModel、rowPaginationFeature、tableFeatures,组装 features 并设置 initialState.pagination。服务端模式传入 manualPagination: true 与 rowCount,数据须为已处理好的当前页;提供 rowCount 或 pageCount 之一。
限制与注意事项:manualPagination 不会自动切片,所传 data 被直接视为当前页;缺少服务端总数时无法正确反映末页与下一页可用性;客户端数据或处理变化可能重置页码,需保留产品状态时应设置 autoResetPageIndex: false。
其他细节(如具体 API 名称与重置规则)可在 node_modules/@tanstack/table-core/dist/features/row-pagination/ 目录中查看。