Skip to content

表格组件

表格组件

表格组件用于展示结构化数据,支持多级表头、固定列、固定行、虚拟滚动、排序、筛选等特性。

基础用法

基础表格用于展示简单的表格数据。

显示代码箭头
复制GitHub

多级表头

通过 columnschildren 属性可以创建多级表头。

显示代码箭头
复制GitHub

虚拟滚动

当需要展示大量数据时,可以启用虚拟滚动以提高性能。

总数据量: 5000 条
显示代码箭头
复制GitHub

固定列

通过设置 columns 中的 fixed 属性可以固定列。

显示代码箭头
复制GitHub

固定行

通过 fixedRow 属性可以设置特定行固定不随滚动而移动。

显示代码箭头
复制GitHub

排序和筛选

表格支持列排序和筛选功能。

显示代码箭头
复制GitHub

自定义渲染

通过 renderrenderHead 属性可以自定义单元格和表头内容。

显示代码箭头
复制GitHub

选择与事件

表格支持行选择功能和各种事件处理。


事件记录:
显示代码箭头
复制GitHub

样式配置

表格提供了丰富的样式配置选项,包括边框、斑马纹等。

表头背景色:
表尾背景色:
悬浮背景色:
边框颜色:
斑马纹:
显示代码箭头
复制GitHub

合计行

通过 summary 属性可以设置表格底部的合计行。

显示代码箭头
复制GitHub

表格 API

属性

属性名说明类型可选值默认值
columns表格列配置array[]
data表格数据源array[]
height表格高度number
isVirtualized是否启用虚拟滚动booleanfalse
virtualizedItemHeight虚拟滚动行高number50
headBgColor表头背景色string#f5f7fa
footBgColor表尾背景色string#f5f7fa
hoverBgColor鼠标悬浮背景色string
border表格边框string#dcdcdc68
stripe斑马纹boolean/stringfalse
dbClickAutoWidth是否支持双击自适应列宽booleantrue
changeType选择模式stringsingle/multiple/nonenone
changeKey选中标识字段string_checked
fixedRow固定行方法function(index, row)
summary合计行配置boolean/function
rowStyle自定义行样式function(index, row)
sortMethod自定义排序方法function
renderExtend行扩展内容function(row)

列配置

属性名说明类型可选值默认值
prop列字段名string
label列标题string
width列宽度number
fixed固定列位置stringleft/right
children子列配置array
sort排序值number
sortable是否可排序booleanfalse
filters筛选配置array
renderHead自定义表头渲染function(scope)
render自定义单元格渲染function(scope)

事件

事件名说明回调参数
checked选中事件({ row: object, data: array })
checked-all全选事件({ row: object, _checked: boolean })
change-filter筛选触发(col: TableColumnsType)
click-row行点击事件(row: object)

方法

方法名说明参数
autoColWidth自动调整列宽度(prop: string)

样式变量

表格组件使用了以下样式变量,可通过 SCSS 变量进行自定义:

变量名说明
$border-color-default默认边框颜色
$text-color-default默认文本颜色
$bg-color-default默认背景颜色
$bg-color-hover悬停背景颜色
$z-index-show显示层级
$z-index-up上层层级

基于MIT许可发布