用途:帮助开发者用 TanStack Table v8 构建无头(headless)数据表格,重点覆盖服务器端分页、筛选、排序等模式,并适配 Cloudflare Workers 与 D1 数据库。触发场景包括提到 data table/datagrid、服务器端分页或筛选、TanStack Table/React Table、大数据集表格、与 API 配合的分页/筛选/排序、Cloudflare D1 表格集成、虚拟化表格等。
主要能力:提供 6 个生产模板(基础客户端表格、服务器分页表格、D1 集成、列配置、虚拟化大数据集、shadcn/ui 样式表格);服务器端分页/筛选/排序与状态管理、URL 同步、TanStack Query 协同;Cloudflare D1 查询、Workers API 端点、绑定配置;用 TanStack Virtual 做虚拟化;并记录 6 类常见错误及解决办法。
使用方式:安装命令为 npm install @tanstack/react-table@latest,虚拟化可选 npm install @tanstack/react-virtual@latest。资料标注版本 @tanstack/react-table v8.21.3、@tanstack/react-virtual v3.13.12。客户端表格需传入 data、columns 和 getCoreRowModel;服务器端需设置 manualPagination、manualFiltering、manualSorting 为 true 并提供 pageCount。大数据集建议搭配 TanStack Query 并让 queryKey 包含全部分页、筛选、排序状态。
适用场景与限制:适合需要无头表格逻辑、无固定 UI 的项目,以及 1000+ 行或频繁变化数据的服务器端方案。客户端表格数据与列须用 useMemo 或 useState 保持稳定引用,否则会无限重渲染;创建列辅助函数应从 @tanstack/react-table 导入。1000 行以上建议服务器端分页或虚拟化。资料未提供收费、价格与官方站点信息。