SuperAPI AI 工具集

tanstack-table-core-typescript

编程与开发

查看项目

更新于 10-16 06:24

技能介绍

用途:该技能针对 TanStack Table v9 的类型系统,帮助在用户代码中保留列与访问器的类型推断,避免 ColumnDef 相关报错,并编写可复用的列定义与表格选项。

主要能力:通过 createColumnHelper、columns()、tableOptions、tableFeatures 和 metaHelper 组合,让特性对象与辅助函数把类型传递到用户代码。columns() 会保留每个访问器各自的 TValue,而不是把数组类型拓宽;tableOptions 适合抽取可复用的选项片段;tableFeatures 配合 metaHelper 可定义按表作用域的列元数据类型。

使用方式:从 @tanstack/table-core 导入 createColumnHelper、metaHelper、tableFeatures。先用 tableFeatures({ columnMeta: metaHelper<ColumnMeta>() }) 定义特性,再用 createColumnHelper<typeof features, Person>() 创建 helper,最后用 helper.columns([...]) 生成列。一次性配置可直接使用适配器选项。

常见错误:不要用宽泛的 ColumnDef<typeof features, Person, unknown>[] 注解列数组,否则会丢失访问器具体的值类型;不要手动串联内部特性泛型,应使用 typeof features;不要用 declare module 全局合并每表 meta,应通过 tableFeatures 的类型槽限定作用域。

限制:资料未提供安装命令、版本兼容范围、收费信息或具体平台支持情况。API 发现建议查看 node_modules/@tanstack/table-core/dist/helpers/ 与 dist/index.d.ts 的导出签名,避免把深层内部泛型签名复制到应用代码中。