基础用法

多选

排序

如果需要排序,步骤如下:

在ct-table外设置一个唯一的dom节点,并将dom节点的id字符串(不含#号)传入ct-table的<teleportDom属性中。
将需要排序的columnData字段的sortable设置为true。
v-model:default-sort绑定默认的排序参数值。

横向滚动

空状态

表格的空状态展示可以在注册组件的时候传入表格空状态的节点配置(tableEmptyDom),即可以 app.use(CtComponents, { tableEmptyDom: '表格空状态节点' }),进行表格的全局配置。
也可以使用empty插槽对当前表格的空状态进行显示。注意!如果使用了empty插槽,那么全局配置的tableEmptyDom将不会生效。
同时也可以使用emptyText来直接设置表格空数据下的文字展示

表格 Attributes

属性名说明类型默认值
tableProps表格的行列数据Object{columnData:[],tableData:[]}
columnWidth设置表格列的宽度数组Array[]
mergeList规范的合并单元格数组Array-
isMultiSelect是否开启多选Booleanfalse
multiSelect选中的多选数组(实时双向绑定)Array[]
teleportDom排序时所传入的排序dom节点的id字符串名String-
defaultSort默认的排序列的 prop 和顺序。 它的 prop 属性指定默认的排序的列,order 指定默认排序的顺序Object{}
pagination前端分页的标志,值代表pageSize的大小Number/String-
emptyText表格空数据的展示文字String暂无数据
alignLeftKeys需要左对齐的表格字段的valueArray-
alignRightKeys需要右对齐的表格字段的valueArray-

其他属性请参考element-plus Table 属性open in new window

columnData字段说明

属性名说明
labeltable-column上的label
valuetable-column上的prop
fixedWidthtable-column上的width
widthtable-column上的min-width
sortabletable-column上的sortable
aligntable-column上的align
fixedtable-column上的fixed
rawAttr放在这个对象里面的属性会通过v-bind的形式绑定到table-column上,也就是可以通过这个属性,控制table-column上原始属性

TIP

table-columnshow-overflow-tooltip默认是true,如果不需要,可以在rawAttr中设置为false

列 Attributes

参考element-plus Table-column属性open in new window

Last Updated:
Contributors: niewk, moujj