Table表格
Table
表格
展示行列数据。
使用import{ Table }from"antd"; |
文档编辑此页 |
- 组件总览
- 通用
- 布局
- 导航
- 数据录入
- 数据展示
- 反馈
- 其他
指定表格的数据源 dataSource 为一个数组。
const dataSource = [{key: '1',name: '胡彦斌',age: 32,address: '西湖区湖底公园1号',},{key: '2',name: '胡彦祖',age: 42,address: '西湖区湖底公园1号',},];const columns = [{title: '姓名',dataIndex: 'name',key: 'name',},{title: '年龄',dataIndex: 'age',key: 'age',},{title: '住址',dataIndex: 'address',key: 'address',},];<Table dataSource={dataSource} columns={columns} />;
antd Table 之上扩展了更多便捷易用的功能，内置搜索、筛选、刷新等常用表格行为，并为多种类型数据展示提供了内置格式化。| Name | Age | Address | Tags | Action |
|---|---|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park | NICEDEVELOPER | |
| Jim Green | 42 | London No. 1 Lake Park | LOSER | |
| Joe Black | 32 | Sydney No. 1 Lake Park | COOLTEACHER |
简单的表格，最后一列是各种操作。
| Name | Age | Address | Tags | Action | |
|---|---|---|---|---|---|
| First Name | Last Name | ||||
| John | Brown | 32 | New York No. 1 Lake Park | NICEDEVELOPER | |
| Jim | Green | 42 | London No. 1 Lake Park | LOSER | |
| Joe | Black | 32 | Sydney No. 1 Lake Park | COOLTEACHER | |
使用 JSX 风格的 API（2.5.0 以后引入）
这个只是一个描述
columns的语法糖，所以你不能用其他组件去包裹Column和ColumnGroup。
| Name | Age | Address | |
|---|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park | |
| Jim Green | 42 | London No. 1 Lake Park | |
| Joe Black | 32 | Sydney No. 1 Lake Park | |
| Disabled User | 99 | Sydney No. 1 Lake Park |
第一列是联动的选择框。可以通过 rowSelection.type 属性指定选择类型，默认为 checkbox。
默认点击 checkbox 触发选择行为，需要点击行触发可以参考例子：https://codesandbox.io/s/000vqw38rl
| Name | Age | Address | |
|---|---|---|---|
| Edward King 0 | 32 | London, Park Lane no. 0 | |
| Edward King 1 | 32 | London, Park Lane no. 1 | |
| Edward King 2 | 32 | London, Park Lane no. 2 | |
| Edward King 3 | 32 | London, Park Lane no. 3 | |
| Edward King 4 | 32 | London, Park Lane no. 4 | |
| Edward King 5 | 32 | London, Park Lane no. 5 | |
| Edward King 6 | 32 | London, Park Lane no. 6 | |
| Edward King 7 | 32 | London, Park Lane no. 7 | |
| Edward King 8 | 32 | London, Park Lane no. 8 | |
| Edward King 9 | 32 | London, Park Lane no. 9 |
选择后进行操作，完成后清空选择，通过 rowSelection.selectedRowKeys 来控制选中项。
| Name | Age | Address | |
|---|---|---|---|
| Edward King 0 | 32 | London, Park Lane no. 0 | |
| Edward King 1 | 32 | London, Park Lane no. 1 | |
| Edward King 2 | 32 | London, Park Lane no. 2 | |
| Edward King 3 | 32 | London, Park Lane no. 3 | |
| Edward King 4 | 32 | London, Park Lane no. 4 | |
| Edward King 5 | 32 | London, Park Lane no. 5 | |
| Edward King 6 | 32 | London, Park Lane no. 6 | |
| Edward King 7 | 32 | London, Park Lane no. 7 | |
| Edward King 8 | 32 | London, Park Lane no. 8 | |
| Edward King 9 | 32 | London, Park Lane no. 9 |
通过 rowSelection.selections 自定义选择项，默认不显示下拉选项，设为 true 时显示默认选择项。
Name | Age | Address |
|---|---|---|
| Jim Green | 42 | London No. 1 Lake Park |
| John Brown | 32 | New York No. 1 Lake Park |
| Joe Black | 32 | Sydney No. 1 Lake Park |
| Jim Red | 32 | London No. 2 Lake Park |
对某一列数据进行筛选，使用列的 filters 属性来指定需要筛选菜单的列，onFilter 用于筛选当前数据，filterMultiple 用于指定多选和单选，filterOnClose 用于指定是否在筛选菜单关闭时触发筛选。
使用 defaultFilteredValue 属性，设置列的默认筛选项。
对某一列数据进行排序，通过指定列的 sorter 函数即可启动排序按钮。sorter: function(rowA, rowB) { ... }， rowA、rowB 为比较的两个行数据。
sortDirections: ['ascend', 'descend'] 改变每列可用的排序方式，切换排序时按数组内容依次切换，设置在 table props 上时对所有列生效。你可以通过设置 ['ascend', 'descend', 'ascend'] 禁止排序恢复到默认状态。
使用 defaultSortOrder 属性，设置列的默认排序顺序。
如果 sortOrder 或者 defaultSortOrder 的值为 ascend 或者 descend，则可以通过 sorter 的函数第三个参数获取当前排序的状态。该函数可以是 function(a, b, sortOrder) { ... } 的形式。
Name | Age | Address |
|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park |
| Jim Green | 42 | London No. 1 Lake Park |
| Joe Black | 32 | Sydney No. 1 Lake Park |
| Jim Red | 32 | London No. 2 Lake Park |
可以使用 filterMode 来修改筛选菜单的 UI，可选值有 menu（默认）和 tree。
Name | Age | Address |
|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park |
| Jim Green | 42 | London No. 1 Lake Park |
| Joe Black | 32 | Sydney No. 1 Lake Park |
| Jim Red | 32 | London No. 2 Lake Park |
filterSearch 用于开启筛选项的搜索，通过 filterSearch:(input, record) => boolean 设置自定义筛选方法
| Name | Chinese Score | Math Score | English Score |
|---|---|---|---|
| John Brown | 98 | 60 | 70 |
| Jim Green | 98 | 66 | 89 |
| Joe Black | 98 | 90 | 70 |
| Jim Red | 88 | 99 | 89 |
column.sorter 支持 multiple 字段以配置多列排序优先级。通过 sorter.compare 配置排序逻辑，你可以通过不设置该函数只启动多列排序的交互形式。
Name | Age | Address |
|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park |
| Jim Green | 42 | London No. 1 Lake Park |
| Joe Black | 32 | Sydney No. 1 Lake Park |
| Jim Red | 32 | London No. 2 Lake Park |
使用受控属性对筛选和排序状态进行控制。
- columns 中定义了 filteredValue 和 sortOrder 属性即视为受控模式。
- 只支持同时对一列进行排序，请保证只有一列的 sortOrder 属性是生效的。
- 务必指定
column.key。
Name | Age | Address |
|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park |
| Joe Black | 42 | London No. 1 Lake Park |
| Jim Green | 32 | Sydney No. 1 Lake Park |
| Jim Red | 32 | London No. 2 Lake Park |
通过 filterDropdown 自定义的列筛选功能，并实现一个搜索列的示例。
给函数 clearFilters 添加 boolean 类型参数 closeDropdown，是否关闭筛选菜单，默认为 true。添加 boolean 类型参数 confirm，清除筛选时是否提交已选项，默认 true。
Name | Gender | |
|---|---|---|
暂无数据 | ||
| Name | Age | Address |
|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park |
| Jim Green | 42 | London No. 1 Lake Park |
| Joe Black | 32 | Sydney No. 1 Lake Park |
| Name | Age | Address |
|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park |
| Jim Green | 42 | London No. 1 Lake Park |
| Joe Black | 32 | Sydney No. 1 Lake Park |
两种紧凑型的列表，小型列表只用于对话框内。
| Name | Cash Assets | Address |
|---|---|---|
| John Brown | ￥300,000.00 | New York No. 1 Lake Park |
| Jim Green | ￥1,256,000.00 | London No. 1 Lake Park |
| Joe Black | ￥120,000.00 | Sydney No. 1 Lake Park |
添加表格边框线，页头和页脚。
当表格内容较多不能一次性完全展示时。
| Name | Age | Address | ||
|---|---|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park | ||
| Jim Green | 42 | London No. 1 Lake Park | ||
| Not Expandable | 29 | Jiangsu No. 1 Lake Park | ||
| Joe Black | 32 | Sydney No. 1 Lake Park |
你可以通过 Table.EXPAND_COLUMN 和 Table.SELECTION_COLUMN 来控制选择和展开列的顺序。
| RowHead | Name | Age | Home phone | Address | |
|---|---|---|---|---|---|
| 1 | John Brown | 32 | 0571-22098909 | 18889898989 | New York No. 1 Lake Park |
| 2 | Jim Green | ||||
| 3 | Joe Black | 32 | 0575-22098909 | 18900010002 | Sydney No. 1 Lake Park |
| 4 | Jim Red | 18 | 0575-22098909 | 18900010002 | London No. 2 Lake Park |
| 5 | Jake White | 18 | 18900010002 | Dublin No. 2 Lake Park | |
表头只支持列合并，使用 column 里的 colSpan 进行设置。
表格支持行/列合并，当 onCell 里的单元格属性 colSpan 或者 rowSpan 设值为 0 时，设置的表格不会渲染。
| Name | Age | Address | |
|---|---|---|---|
| John Brown sr. | 60 | New York No. 1 Lake Park | |
| Joe Black | 32 | Sydney No. 1 Lake Park |
表格支持树形数据的展示，当数据中有 children 字段时会自动展示为树形表格，如果不需要或配置为其他字段可以用 childrenColumnName 进行配置。
可以通过设置 indentSize 以控制每一层的缩进宽度。
| Edward King 0 | 32 | London, Park Lane no. 0 |
| Edward King 1 | 32 | London, Park Lane no. 1 |
| Edward King 2 | 32 | London, Park Lane no. 2 |
| Edward King 3 | 32 | London, Park Lane no. 3 |
| Edward King 4 | 32 | London, Park Lane no. 4 |
| Edward King 5 | 32 | London, Park Lane no. 5 |
| Edward King 6 | 32 | London, Park Lane no. 6 |
| Edward King 7 | 32 | London, Park Lane no. 7 |
| Edward King 8 | 32 | London, Park Lane no. 8 |
| Edward King 9 | 32 | London, Park Lane no. 9 |
| Edward King 10 | 32 | London, Park Lane no. 10 |
| Edward King 11 | 32 | London, Park Lane no. 11 |
| Edward King 12 | 32 | London, Park Lane no. 12 |
| Edward King 13 | 32 | London, Park Lane no. 13 |
| Edward King 14 | 32 | London, Park Lane no. 14 |
| Edward King 15 | 32 | London, Park Lane no. 15 |
| Edward King 16 | 32 | London, Park Lane no. 16 |
| Edward King 17 | 32 | London, Park Lane no. 17 |
| Edward King 18 | 32 | London, Park Lane no. 18 |
| Edward King 19 | 32 | London, Park Lane no. 19 |
| Edward King 20 | 32 | London, Park Lane no. 20 |
| Edward King 21 | 32 | London, Park Lane no. 21 |
| Edward King 22 | 32 | London, Park Lane no. 22 |
| Edward King 23 | 32 | London, Park Lane no. 23 |
| Edward King 24 | 32 | London, Park Lane no. 24 |
| Edward King 25 | 32 | London, Park Lane no. 25 |
| Edward King 26 | 32 | London, Park Lane no. 26 |
| Edward King 27 | 32 | London, Park Lane no. 27 |
| Edward King 28 | 32 | London, Park Lane no. 28 |
| Edward King 29 | 32 | London, Park Lane no. 29 |
| Edward King 30 | 32 | London, Park Lane no. 30 |
| Edward King 31 | 32 | London, Park Lane no. 31 |
| Edward King 32 | 32 | London, Park Lane no. 32 |
| Edward King 33 | 32 | London, Park Lane no. 33 |
| Edward King 34 | 32 | London, Park Lane no. 34 |
| Edward King 35 | 32 | London, Park Lane no. 35 |
| Edward King 36 | 32 | London, Park Lane no. 36 |
| Edward King 37 | 32 | London, Park Lane no. 37 |
| Edward King 38 | 32 | London, Park Lane no. 38 |
| Edward King 39 | 32 | London, Park Lane no. 39 |
| Edward King 40 | 32 | London, Park Lane no. 40 |
| Edward King 41 | 32 | London, Park Lane no. 41 |
| Edward King 42 | 32 | London, Park Lane no. 42 |
| Edward King 43 | 32 | London, Park Lane no. 43 |
| Edward King 44 | 32 | London, Park Lane no. 44 |
| Edward King 45 | 32 | London, Park Lane no. 45 |
| Edward King 46 | 32 | London, Park Lane no. 46 |
| Edward King 47 | 32 | London, Park Lane no. 47 |
| Edward King 48 | 32 | London, Park Lane no. 48 |
| Edward King 49 | 32 | London, Park Lane no. 49 |
方便一页内展示大量数据。
需要指定 column 的 width 属性，否则列头和内容可能不对齐。如果指定 width 不生效或出现白色垂直空隙，请尝试建议留一列不设宽度以适应弹性布局，或者检查是否有超长连续字段破坏布局。
对于列数很多的数据，可以固定前后的列，横向滚动查看其它数据，需要和 scroll.x 配合使用。
若列头与内容不对齐或出现列重复，请指定固定列的宽度
width。如果指定width不生效或出现白色垂直空隙，请尝试建议留一列不设宽度以适应弹性布局，或者检查是否有超长连续字段破坏布局。建议指定
scroll.x为大于表格宽度的固定值或百分比。注意，且非固定列宽度之和不要超过scroll.x。
注意：v4 版本固定列通过 sticky 实现，IE 11 会降级成横向滚动。
混合固定列，滚动到一定距离进行堆叠，推荐配合 bordered 使用。
| Edward 0 | 32 | London Park no. 0 | London Park no. 0 | London Park no. 0 | London Park no. 0 | London Park no. 0 | London Park no. 0 | London Park no. 0 | London Park no. 0 | action |
| Edward 1 | 32 | London Park no. 1 | London Park no. 1 | London Park no. 1 | London Park no. 1 | London Park no. 1 | London Park no. 1 | London Park no. 1 | London Park no. 1 | action |
| Edward 2 | 32 | London Park no. 2 | London Park no. 2 | London Park no. 2 | London Park no. 2 | London Park no. 2 | London Park no. 2 | London Park no. 2 | London Park no. 2 | action |
| Edward 3 | 32 | London Park no. 3 | London Park no. 3 | London Park no. 3 | London Park no. 3 | London Park no. 3 | London Park no. 3 | London Park no. 3 | London Park no. 3 | action |
| Edward 4 | 32 | London Park no. 4 | London Park no. 4 | London Park no. 4 | London Park no. 4 | London Park no. 4 | London Park no. 4 | London Park no. 4 | London Park no. 4 | action |
| Edward 5 | 32 | London Park no. 5 | London Park no. 5 | London Park no. 5 | London Park no. 5 | London Park no. 5 | London Park no. 5 | London Park no. 5 | London Park no. 5 | action |
| Edward 6 | 32 | London Park no. 6 | London Park no. 6 | London Park no. 6 | London Park no. 6 | London Park no. 6 | London Park no. 6 | London Park no. 6 | London Park no. 6 | action |
| Edward 7 | 32 | London Park no. 7 | London Park no. 7 | London Park no. 7 | London Park no. 7 | London Park no. 7 | London Park no. 7 | London Park no. 7 | London Park no. 7 | action |
| Edward 8 | 32 | London Park no. 8 | London Park no. 8 | London Park no. 8 | London Park no. 8 | London Park no. 8 | London Park no. 8 | London Park no. 8 | London Park no. 8 | action |
| Edward 9 | 32 | London Park no. 9 | London Park no. 9 | London Park no. 9 | London Park no. 9 | London Park no. 9 | London Park no. 9 | London Park no. 9 | London Park no. 9 | action |
适合同时展示有大量数据和数据列。
若列头与内容不对齐或出现列重复，请指定固定列的宽度
width。如果指定width不生效或出现白色垂直空隙，请尝试建议留一列不设宽度以适应弹性布局，或者检查是否有超长连续字段破坏布局。建议指定
scroll.x为大于表格宽度的固定值或百分比。注意，且非固定列宽度之和不要超过scroll.x。
| John Brown | 1 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
| John Brown | 2 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
| John Brown | 3 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
| John Brown | 4 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
| John Brown | 5 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
| John Brown | 6 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
| John Brown | 7 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
| John Brown | 8 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
| John Brown | 9 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
| John Brown | 10 | Lake Park | C | 2035 | Lake Street 42 | SoftLake Co | M |
columns[n] 可以内嵌 children，以渲染分组表头。
带单元格编辑功能的表格。当配合 shouldCellUpdate 使用时请注意闭包问题。
| name | age | address | operation |
|---|---|---|---|
| Edward 0 | 32 | London Park no. 0 | Edit |
| Edward 1 | 32 | London Park no. 1 | Edit |
| Edward 2 | 32 | London Park no. 2 | Edit |
| Edward 3 | 32 | London Park no. 3 | Edit |
| Edward 4 | 32 | London Park no. 4 | Edit |
| Edward 5 | 32 | London Park no. 5 | Edit |
| Edward 6 | 32 | London Park no. 6 | Edit |
| Edward 7 | 32 | London Park no. 7 | Edit |
| Edward 8 | 32 | London Park no. 8 | Edit |
| Edward 9 | 32 | London Park no. 9 | Edit |
带行编辑功能的表格。
🛎️ 想要 3 分钟实现？试试 ProTable 的可编辑表格！
展示每行数据更详细的信息。
| Name | Age | Address |
|---|---|---|
| John Brown | 32 | Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text Long text |
| Jim Green | 42 | London No. 1 Lake Park |
| Joe Black | 32 | Sidney No. 1 Lake Park |
使用自定义元素，我们可以集成 dnd-kit 来实现拖拽排序。
| Name | Gender | Age | Address | |
|---|---|---|---|---|
| John Brown | male | 32 | John Brown@example.com | London No. 1 Lake Park |
| Jim Green | female | 42 | jimGreen@example.com | London No. 1 Lake Park |
| Joe Black | female | 32 | JoeBlack@example.com | Sidney No. 1 Lake Park |
| George Hcc | male | 20 | george@example.com | Sidney No. 1 Lake Park |
使用自定义元素，我们可以集成 dnd-kit 来实现列拖拽排序。
| Name | Age | Address | |
|---|---|---|---|
| John Brown | 32 | Long text Long | |
| Jim Green | 42 | London No. 1 Lake Park | |
| Joe Black | 32 | Sidney No. 1 Lake Park |
使用 dnd-kit 来实现一个拖拽操作列。
| Name | Age | Address | Long Column Long Column Long Column | Long Column Long Column | Long Column |
|---|---|---|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park, New York No. 1 Lake Park | New York No. 1 Lake Park, New York No. 1 Lake Park | New York No. 1 Lake Park, New York No. 1 Lake Park | New York No. 1 Lake Park, New York No. 1 Lake Park |
| Jim Green | 42 | London No. 2 Lake Park, London No. 2 Lake Park | London No. 2 Lake Park, London No. 2 Lake Park | London No. 2 Lake Park, London No. 2 Lake Park | London No. 2 Lake Park, London No. 2 Lake Park |
| Joe Black | 32 | Sydney No. 1 Lake Park, Sydney No. 1 Lake Park | Sydney No. 1 Lake Park, Sydney No. 1 Lake Park | Sydney No. 1 Lake Park, Sydney No. 1 Lake Park | Sydney No. 1 Lake Park, Sydney No. 1 Lake Park |
设置 column.ellipsis 可以让单元格内容根据宽度自动省略。
列头缩略暂不支持和排序筛选一起使用。
| Name | Age | Address | Long Column Long Column Long Column | Long Column Long Column | Long Column |
|---|---|---|---|---|---|
| John Brown | 32 | New York No. 1 Lake Park, New York No. 1 Lake Park | New York No. 1 Lake Park, New York No. 1 Lake Park | New York No. 1 Lake Park, New York No. 1 Lake Park | New York No. 1 Lake Park, New York No. 1 Lake Park |
| Jim Green | 42 | London No. 2 Lake Park, London No. 2 Lake Park | London No. 2 Lake Park, London No. 2 Lake Park | London No. 2 Lake Park, London No. 2 Lake Park | London No. 2 Lake Park, London No. 2 Lake Park |
| Joe Black | 32 | Sydney No. 1 Lake Park, Sydney No. 1 Lake Park | Sydney No. 1 Lake Park, Sydney No. 1 Lake Park | Sydney No. 1 Lake Park, Sydney No. 1 Lake Park | Sydney No. 1 Lake Park, Sydney No. 1 Lake Park |
设置 column.ellipsis.showTitle 关闭单元格内容自动省略后默认的 title 提示, 使用 Tooltip 替代。
| Name | Age | Address |
|---|---|---|
| Edward King 0 | 32 | London, Park Lane no. 0 |
| Edward King 1 | 33 | London, Park Lane no. 1 |
| Edward King 2 | 34 | London, Park Lane no. 2 |
| Edward King 3 | 35 | London, Park Lane no. 3 |
| Edward King 4 | 36 | London, Park Lane no. 4 |
自定义空状态。
| Name | Borrow | Repayment |
|---|---|---|
| John Brown | 10 | 33 |
| Jim Green | 100 | 0 |
| Joe Black | 10 | 10 |
| Jim Red | 75 | 45 |
| Total | 195 | 88 |
| Balance | 107 | |
| Light | Everything that has a beginning, has an end. |
| Bamboo | Everything that has a beginning, has an end. |
| Little | Everything that has a beginning, has an end. |
| Light | Everything that has a beginning, has an end. |
| Bamboo | Everything that has a beginning, has an end. |
| Little | Everything that has a beginning, has an end. |
| Light | Everything that has a beginning, has an end. |
| Bamboo | Everything that has a beginning, has an end. |
| Little | Everything that has a beginning, has an end. |
| Light | Everything that has a beginning, has an end. |
| Bamboo | Everything that has a beginning, has an end. |
| Little | Everything that has a beginning, has an end. |
| Light | Everything that has a beginning, has an end. |
| Bamboo | Everything that has a beginning, has an end. |
| Little | Everything that has a beginning, has an end. |
| Light | Everything that has a beginning, has an end. |
| Bamboo | Everything that has a beginning, has an end. |
| Little | Everything that has a beginning, has an end. |
| Light | Everything that has a beginning, has an end. |
| Bamboo | Everything that has a beginning, has an end. |
通过 summary 设置总结栏。使用 Table.Summary.Cell 同步 Column 的固定状态。你可以通过配置 Table.Summary 的 fixed 属性使其固定(4.16.0 支持)。
通过 virtual 开启虚拟滚动，此时 scroll.x 与 scroll.y 必须设置且为 number 类型。
| Name (all screens) |
|---|
| John Brown |
