基础用法
多选
排序
如果需要排序,步骤如下:
在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 | 是否开启多选 | Boolean | false |
multiSelect | 选中的多选数组(实时双向绑定) | Array | [] |
teleportDom | 排序时所传入的排序dom节点的id字符串名 | String | - |
defaultSort | 默认的排序列的 prop 和顺序。 它的 prop 属性指定默认的排序的列,order 指定默认排序的顺序 | Object | {} |
pagination | 前端分页的标志,值代表pageSize的大小 | Number/String | - |
emptyText | 表格空数据的展示文字 | String | 暂无数据 |
alignLeftKeys | 需要左对齐的表格字段的value | Array | - |
alignRightKeys | 需要右对齐的表格字段的value | Array | - |
其他属性请参考element-plus Table 属性
columnData字段说明
属性名 | 说明 |
---|---|
label | table-column 上的label |
value | table-column 上的prop |
fixedWidth | table-column 上的width |
width | table-column 上的min-width |
sortable | table-column 上的sortable |
align | table-column 上的align |
fixed | table-column 上的fixed |
rawAttr | 放在这个对象里面的属性会通过v-bind的形式绑定到table-column 上,也就是可以通过这个属性,控制table-column 上原始属性 |
TIP
table-column
的show-overflow-tooltip
默认是true,如果不需要,可以在rawAttr
中设置为false