表格

基于 React Aria 构建的可访问表原语 - 语义变量、键盘导航、行选择和可排序列。将其与 TanStack Table 配对以实现排序、过滤和分页逻辑,如下例所示。

总结果

48 顾客

购买状态行动
约翰·克拉克森
发送失败2026年9月5日$3.412
阿斯彭·鲁宾
发送失败2026年3月25日$1.899
迈克尔·埃克斯特罗姆
已发货2026年8月1日$2.752
基安娜·瓦卡罗
已发货2026年4月2日$145
利维娅·萨里斯
发送失败2026年11月14日$708
杰登·阿米诺夫
送货等待2026年7月17日$224
玛丽亚·卢宾
已发货2026年11月15日$2.959
Ann Press
送货等待2026年9月20日$2.646

安装

您可以使用我们的 CLI 或手动添加此表组件:

已支持深色模式,此 组件 会自动使用 BoardUI 的语义设计变量。 设置主题切换.

CLI 将组件源(及其内部依赖项)复制到您的项目中并安装任何所需的 npm 包。

npx boardui@latest add table

使用共享 UI 包或自定义导入别名? 配置您的安装路径 在运行 CLI 之前。复制粘贴示例使用默认导入。

尺寸

该桌子有 2 种尺寸: md (正常)和 sm (紧凑,填充更紧,头像更小)。通过更改在它们之间切换 size 支撑在 Table 组件 - 尝试 普通/紧凑 在上面的预览中切换。

<Table size="md" aria-label="Customers"> {/* rest of the table components */}</Table>

加载中

传入 isLoading,表体就会在真实表头下变成一页 Skeleton 占位行,在两种密度下每个单元格都与将要显示的内容大小一致,数据到达时不会有任何移动。

总结果

购买状态行动
const { data, isLoading } = useCustomers(); // The header stays; the body is a page of Skeleton rows until the data lands.<DataTableExample isLoading={isLoading} />

目录

本指南展示了如何使用 TanStack Table - 用于行、列、排序、过滤和选择的无头引擎 - 以及 Table 构建您自己的数据表的原语。我们将讨论以下主题:

  • 带有 Table 原语的基本表
  • 行选择
  • 排序
  • 过滤和搜索
  • 分页
  • 可重复使用的组件