数据网格

应用中的电子表格。编辑单元格、选择范围、筛选记录,并借助固定首列和实时汇总处理数千行数据。

Renewals

Total Results10,000 rows

Use arrow keys to navigate, Shift and arrows to select cells, and Enter or F2 to edit. Copy and paste cells with your keyboard. Column headings sort; column separators resize with arrow keys.

Northwind Freight
Owen Park
Latin America
Closed won
40
$9,600
49%
Lumen Freight
Tyler Hayes
Europe
Closed won
105
$37,800
90%
Cedar Freight
Tyler Hayes
Latin America
Proposal
230
$96,600
64%
Brightline Freight
Marcus Johnson
Asia Pacific
Proposal
115
$41,400
78%
Harbor Freight
Daniel Kim
Latin America
Committed
10
$4,200
72%
Pinecrest Freight
Marcus Johnson
Europe
Closed won
470
$169,200
72%
Atlas Freight
Sarah Bennett
Latin America
Discovery
45
$16,200
95%
Summit Freight
Owen Park
Asia Pacific
Negotiation
255
$107,100
93%
Fieldstone Freight
Marcus Johnson
Europe
Discovery
660
$237,600
82%
Evergreen Freight
Marcus Johnson
Latin America
Negotiation
46
$13,800
56%
Meridian Freight
Owen Park
Asia Pacific
Discovery
119
$42,840
73%
Redwood Freight
Daniel Kim
Europe
Committed
192
$80,640
90%
Westbridge Freight
Tyler Hayes
North America
Proposal
265
$63,600
41%
Sum3.3M
Sum$1.1B
Avg67.5%
A1Count 1

安装

使用我们的 CLI 添加免费的数据网格,其中包含所需的 BoardUI 控件和内部数据辅助工具:

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

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

npx boardui@latest add data-grid

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

列与编辑

传入有类型的 columns,你的 data,以及唯一且稳定的 getRowId。提供 onDataChange 以启用编辑。文本、数字和选择编辑器复用 BoardUI 输入框及选择控件。使用以下属性设置范围 min 和 max,或使用以下方式拒绝值 validate.

使用 format 用于单元格显示,以及 formatSummary 用于显示总和、平均值或计数的页脚。设置 editable= 用于各个列。格式设置只改变显示方式;编辑、复制和导出均使用原始值。

const columns: DataGridColumn<Account>[] = [ { key: "account", header: "Account", width: 220, validate: (value) => String(value).trim() ? undefined : "Account cannot be empty." }, { key: "stage", header: "Stage", type: "select", options: ["Discovery", "Proposal", "Closed won"] }, { key: "seats", header: "Seats", type: "number", min: 0, summary: "sum" }, { key: "arr", header: "ARR", type: "number", min: 0, editable: false, summary: "sum", formatSummary: (value) => `$${value.toLocaleString("en-US")}` },]; // Omit onDataChange to make every cell read-only.<DataGrid aria-label="Accounts" data={data} columns={columns} getRowId={getRowId} />

搜索、筛选与导出

搜索所有列,点击标题可在升序、降序和原始顺序间切换,也可按精确值筛选。选择型列会自动显示在筛选菜单中;添加 filterable 到其他列。隐藏列、拖动分隔线调整列宽,并在舒适行与紧凑行之间切换。

第一个可见列固定在行号旁边。在窄屏上,它会随其他列滚动,以确保每个单元格都可访问。行复选框独立于单元格范围选择记录;表头复选框可切换全部筛选后的行。选中行后,工具栏显示数量以及删除、复制和导出操作。复制使用制表符分隔的值,导出下载 CSV;两者均使用可见列和选中的可见记录。删除需要 onDataChange 且可以撤销。清除选择即可返回搜索和视图控件。汇总始终反映筛选后的记录。

键盘与剪贴板

按 Tab 进入网格,使用箭头键在单元格间移动。按住 Shift 扩展范围,或使用鼠标跨单元格拖动。Home 和 End 在行内移动;加上 ⌘ 或 Ctrl 可跳至第一条或最后一条记录。Page Up 和 Page Down 每次移动一个视口。⌘/Ctrl+A 选择所有单元格。

选中带选项的单元格即可显示下拉控件,然后点击箭头选择值。双击、Enter 或 F2 可打开单元格编辑器。Enter 保存并向下移动;Shift+Enter 向上移动。Tab 保存并移至下一个单元格。Escape 取消。使用常用键盘快捷键复制范围并粘贴制表符分隔的电子表格数据。无效值会使整次粘贴被拒绝。撤销和重做适用于单元格编辑、粘贴及行删除,网格挂载期间最多保留 100 次操作。

为每个网格提供 aria-label。将从右向左的区域包裹在 DirectionProvider;固定列、菜单和水平箭头键均遵循阅读方向。

小视口中的 10,000 行

上方预览包含 10,000 条实际记录。固定高度虚拟化仅挂载视口内及其周围的行。表头和汇总保留在滚动区域之外;滚动时顶部边缘会逐渐模糊。设置 height 可更改视口高度。

搜索、排序、筛选和汇总均在浏览器中基于传入的数据执行。记录移动时,单元格选择和编辑会跟随稳定的行 ID。请在以下位置持久化更改 onDataChange 处理函数中。用新的 React key 在切换到不同数据集时重新挂载,以重置视图状态和编辑历史。

从右向左与只读

使用 DirectionProvider 以设置阅读方向。此只读示例将首列固定在右侧,并镜像水平键盘导航。列标签和记录值可以使用任何语言。

Total Results2 rows

Use arrow keys to navigate, Shift and arrows to select cells, and Enter or F2 to edit. Copy and paste cells with your keyboard. Column headings sort; column separators resize with arrow keys.

نورث ويند
أوروبا
40
لومن
آسيا
105
Sum145
A1Count 1Read-only