Skip to content

API 文档

Table 属性

属性名
说明类型可选值默认值
list显示的数据ListItem[]
columns列信息集合Column[]
row-key行id变量名 虚拟列表需要,如果不给保证默认值为idString/Numberid
row-min-height行最小高度 虚拟列表需要。如果不给需要保证最小高度不能低于默认值30Number30
show-header是否显示表头Booleantrue
stripe是否为斑马纹 tableBooleanfalse
border是否带有纵向边框Booleanfalse
highlightSelectRow是否要高亮当前行Booleanfalse
highlightSelectCol是否要高亮当前列Booleanfalse
selection是否支持框选Booleanfalse
default-expand-all是否默认展开所有行,当 Table 包含展开行存在或者为树形表格时有效Booleanfalse
header-row-class-name表头行自定义类(data: { row: Column[]; rowIndex: number }): string() => ''
header-row-style表头行自定义样式(data: { row: Column[]; rowIndex: number }): string() => ''
header-cell-class-name表头单元格自定义类(data: { row: Column[]; column: Column; rowIndex: number; columnIndex: number }): string() => ''
header-cell-style表头单元格自定义样式(data: { row: Column[]; column: Column; rowIndex: number; columnIndex: number }): string() => ''
row-class-name行自定义类(data: { row: ListItem; rowIndex: number }): string() => ''
row-style行自定义样式(data: { row: ListItem; rowIndex: number }): string() => ''
cell-class-name单元格自定义类(data: { row: ListItem; column: Column; rowIndex: number; columnIndex: number }): string() => ''
cell-style单元格自定义样式(data: { row: ListItem; column: Column; rowIndex: number; columnIndex: number }): string() => ''

Column 属性

属性名
说明类型可选值默认值
id必传string|number
title显示的标题string
type对应列的类型。 如果设置了 index 则显示该行的索引(从 1 开始计算); 如果设置了 expand 则显示为一个可展开的按钮;如果设置了checkbox则显示多选框;stringindex / expand / checkbox
index如果设置了 type=index,可以通过传递 index 属性来自定义索引number / function(index)
field字段名称:对应列内容的字段名string|number
width对应列的宽度number
min-width当设置 resizable 时,对应列的最小宽度number
max-width当设置 resizable 时,对应列的最大宽度number
resizable对应列是否可以通过拖动改变宽度(当 border 属性为 false 时,仍然支持调整列宽,但表头会单独显示右边框线)Boolean
fixed列是否固定在左侧或者右侧。string'left' / 'right' / ''
align表格的对齐方式(表头和表身)stringleft / center / rightleft
header-align表头对齐方式, 若不设置该项,则使用表格的对齐方式stringleft / center / right
children嵌套列Column[]
class-name列的 classNamestring
header-render自定义渲染表头单元格function(column)
body-render自定义渲染变身单元格function(column, row)

Table 事件

事件名
说明回调参数
header-click当某一列的表头被点击时会触发该事件data: { event, column }
header-dblclick当某一列的表头被双击时会触发该事件data: { event, column }
header-contextmenu当某一列的表头被鼠标右键点击时触发该事件data: { event, column }
row-click当某一行被点击时会触发该事件data: { event, column, columnIndex, row rowIndex }
row-dblclick当某一行被双击时会触发该事件data: { event, column, columnIndex, row rowIndex }
row-contextmenu当某一行被鼠标右键点击时会触发该事件data: { event, column, columnIndex, row rowIndex }
cell-click当某个单元格被点击时会触发该事件data: { event, column, columnIndex, row, rowIndex, cell }
cell-dblclick当某个单元格被双击击时会触发该事件data: { event, column, columnIndex, row, rowIndex, cell }
cell-contextmenu当某个单元格被鼠标右键点击时会触发该事件data: { event, column, columnIndex, row, rowIndex, cell }
expand-change当用户对某一行展开或者关闭的时候会触发该事件(展开行时,回调的第二个参数为 expandedRows;树形表格时第二参数为 expanded)data: { row, expandedRows }
box-selection当selection选中区域的时候触发该事件data: { areas: area[], cells: [] }