Skip to main content

表格示例

组件引入方式:

import { BaseTable } from 'ali-react-table'

基本用法#

通过 dataSource 设置表格的数据源,通过 columns 设置表格的列。 注意 column.code 要与 dataSource 中的数据字段相对应。

预览点击展开或收拢
源码点击展开或收拢

数据为空状态#

dataSource 的长度为 0 时,表格将展现空状态。上层可以通过 components.EmptyContent 对空状态进行定制。

预览点击展开或收拢
源码点击展开或收拢

数据加载状态#

设置 isLoading=true 即可展示加载动画。

上层可以通过 components.LoadingContentWrappercomponents.LoadingIcon 来定制加载动画。

预览点击展开或收拢
源码点击展开或收拢

左侧锁列#

设置 column.lock=true 即可锁列,锁列的方向与嵌套关系详见 该文档

预览点击展开或收拢
源码点击展开或收拢

表头吸顶#

默认情况下表格已经开启了表头吸顶功能。设置 isStickyHead=false 可以关闭吸顶。

预览点击展开或收拢
表格操作栏,这里适合放置一些功能按钮
源码点击展开或收拢

表头分组#

columns.children=[...] 中添加子节点,<BaseTable /> 会绘制相应的嵌套表头结构。

预览点击展开或收拢
源码点击展开或收拢

单元格合并与自定义单元格样式#

通过 column.getCellProps(...) 返回 colSpan/rowSpan 可实现单元格合并。

除了 colSpan, rowSpan 之外,getCellProps 也可以返回 td 元素的其他 props,例如 className, style, onClick 等。

预览点击展开或收拢
源码点击展开或收拢

自定义表格行样式#

通过 getRowProps(...) 设置 tr 元素上的 props,例如 className, style, onClick 等。

预览点击展开或收拢

点击表格行以改变该行样式

源码点击展开或收拢

限定表格容器大小#

通过 style.width/style.maxWidth 来限定表格的宽度;通过 style.height/style.maxHeight 来限定高度。限定宽度或高度时,要同时设置 style.overflow=auto

预览点击展开或收拢
源码点击展开或收拢

表格页脚#

为表格设置 footerDataSource={[...]} 来添加页脚(总结栏)。

表格页脚默认吸附在表格底部,可通过 isStickyFooter={false} 关闭吸底。

目前表格页脚还不兼容部分表格拓展,所以尽量只在展示类表格中使用表格页脚。

预览点击展开或收拢
源码点击展开或收拢