Skip to content
On this page

表格

目前主要解决两个问题:

  1. el-table-column原先prop 不支持ts类型
  2. 自定义组件整理

基础用法

原先 el-table-column采用属性 columns 替代。使用 defineTableColumns定义columns,提供完善类型支持。

自定义slot--template模式

通过columns下的 slotName属性映射tempalte 下的具名插槽

自定义slot--render模式

通过columns下的 render属性来渲染插槽,支持 h()方法与jsx写法

字典功能

通过columns下的 columnType='dict'属性来设置字典,通过options.list 设置字典选项

表头描述

通过columns下的 headerDescription属性来表头内容

操作行

通过columns下的 columnType='menu'属性来设置操作列,操作列会默认展示2个按钮,其余按钮显示为更多

复制功能

你可以使用 columnType='copy' 属性来使用复制功能

分页

传入total属性即可开启分页

固定表头

你可以使用 'fixHeader'` 属性来使用固定表头功能

高度撑满

你可以使用 height='100%' 属性来撑满表格,请保证组件元素有固定高度,并且需配置display:flex;

HTable 属性

HTable 属性与el-table 相同。分页属性同el-pagination 属性相同。

参数说明类型可选值默认值
lineSpace表格行距-"default" \ "middle" \ "samll"-
loadingloading状态-false\truefalse
showLineSpaceIcon工具栏行距按钮-false\truetrue
showSettingIcon工具栏设置按钮-false\truetrue
fixHeader固定头部,至少需要传入top高度已确定在合适位置固定,scrollContainer表格滚动容器,默认为 document{top: number;scrollContainer?:string }--
columnstable-columns配置项,见下方配置-ITableColumns-

Htable 事件

支持el-table、el-pagination 所有事件

参数说明类型可选值默认值
loadpageSize 和 currentPage 改变时会触发---

columns 配置项

columns 拥有el-table-column所有属性,额外扩展以下属性

参数说明类型可选值默认值
children嵌套表格ITableColumnsdefault-
hide是否隐藏当前列booleantrue-
renderslot渲染行,支持h方法、jsx写法function({$index,column,row},value)-
columnType行扩展类型string"dict"/"image"/"menu"/"copy"-
headerSlotName表头渲染slot名称string--
slotNameslot渲染行,template写法string--
options配置选项ColumnTypeOptions-
headerDescription表头描述string-

Htable 插槽

插槽名说明
leftHandleArea表格工具栏左侧区域
handleArea表格工具栏右侧区域