用途:基于 TanStack Table v8 构建无头(headless)数据表格,重点覆盖服务端分页、过滤、排序、虚拟化,以及与 Cloudflare Workers + D1 的集成。触发场景包括 data table/datagrid、服务端分页或过滤、TanStack Table/React Table、大数据集表格、API 分页过滤排序、D1 表格集成、虚拟化与长列表性能、从其他表格库迁移到 v8。
主要能力:提供 7 个生产模板(基础客户端表格、服务端分页表格、D1 数据库集成、列配置模式、受控表格状态、虚拟化大数据集、shadcn/ui 样式表格);服务端模式(API 分页、查询参数过滤、数据库排序、状态管理、URL 同步、与 TanStack Query 协调);Cloudflare 集成(D1 查询、Workers API 端点、SQL 分页过滤排序、wrangler.jsonc 绑定、客户端集成);性能优化(TanStack Virtual 虚拟化、万行级渲染、useVirtualizer() 集成);功能控制(列可见性、固定列、列排序与尺寸、全局与模糊搜索、分面过滤、行选择与行固定);错误防范(服务端状态管理、Query key 协调、列过滤、手动排序、URL 状态同步、大数据性能、过度控制 columnSizingInfo 导致额外渲染)。
使用方式:安装命令为 bun add @tanstack/react-table@latest,虚拟化可选 bun add @tanstack/react-virtual@latest,模糊搜索可选 bun add @tanstack/match-sorter-utils@latest。已验证版本:@tanstack/react-table v8.21.3、@tanstack/react-virtual v3.13.23、@tanstack/match-sorter-utils v8.21.3。支持 React 16.8+ 至 React 19,不支持 React Compiler。基础用法需 useReactTable 配合 getCoreRowModel,并注意用 useMemo 稳定 data 与 columns 引用。服务端模式需设置 manualPagination、manualFiltering、manualSorting 为 true,并提供 pageCount,同时把分页、过滤、排序状态纳入 TanStack Query 的 queryKey。
适用场景与限制:适合需要分页、过滤、排序、虚拟化或服务端数据源的数据表格,尤其是 1000 行以上或数据频繁变化的场景;客户端模式适合 1000 行以下。限制方面,资料未提供收费、价格、平台支持范围等细节,暂未提供。