Skip to content
On this page

Table 表格

用于展示多条结构类似的数据, 可对数据进行排序、筛选、对比或其他自定义操作。

基础用法

边框表格

复选框表格

单选框表格

序列号表格

双击单元格复制(默认不开启)

字典过滤渲染

表头合并单元格(多级表头)

表头合并(多级表头)-插槽使用

表格操作按钮

集成分页器

某列 render 渲染

Tree-Table

某列 作用域插槽渲染

自定义表头渲染

列--动态显示隐藏且拖动排序

行--拖拽排序

单元格编辑功能

单元格单独编辑

单元格编辑--键盘事件

单元格编辑--使用组件事件

TTable 参数配置


1、代码示例

html
<t-table
  :table="table"
  :columns="table.columns"
  @size-change="handlesSizeChange"
  @page-change="handlesCurrentChange"
/>
<t-table
  :table="table"
  :columns="table.columns"
  @size-change="handlesSizeChange"
  @page-change="handlesCurrentChange"
/>

2、配置参数(Table Attributes)

参数说明类型默认值
table表格数据对象Object{}
---data展示数据Array[]
---toolbar表格外操作栏选中表格某行,可以将其数据传出Array[]
---operator表格内操作栏数据Array[]
-------show表格内操作栏根据状态显示Object-
-------noshow表格内操作栏根据多种状态不显示Array-
---operatorConfig表格内操作栏样式Object-
---firstColumn表格首列(序号 index,复选框 selection)排列object-
---total数据总条数Number-
---pageSize页数量Number-
---currentPage是否需要显示切换页条数Number-
columns表头信息Array[]
----sort排序 (设置:sort:true)Booleanfalse
----renderHeader列标题 Label 区域渲染使用的 Function(val) 可以用 jsx 方式Function-
----bindel-table-column AttributesObject-
----noShowTip是否换行 (设置:noShowTip:true)Booleanfalse
----slotName插槽显示此列数据(其值是具名作用域插槽String-
----slotNameMerge合并表头插槽显示此列数据(其值是具名作用域插槽)String-
----------scope具名插槽获取此行数据必须用解构接收{scope}.row 是当前行数据 }Object-
----canEdit是否开启单元格编辑功能Booleanfalse
----configEdit表格编辑配置(开启编辑功能有效)Object-
----------labelplaceholder 显示String-
----------editComponent组件名称可直接指定全局注册的组件,也可引入'element/abtd'如:'a-input/el-input'String-
----------eventHandle第三方 UI 的 事件(返回两个参数,第一个自己自带,第二个 scope)Object-
----------bind第三方 UI 的 Attributes,如 el-input 中的 clearable 清空功能Object-
----------event触发 handleEvent 事件的标志String-
----------type下拉或者复选框显示(select-arr/select-obj/checkbox)String-
----------list下拉选择数据源名称String-
----------arrLabeltype:select-arr 时对应显示的中文字段String-
----------arrKeytype:select-arr 时对应显示的数字字段String-
----filters字典过滤Object-
----------listlistTypeInfo 里面对应的下拉数据源命名String-
----------key数据源的 key 字段String'value'
----------label数据源的 label 字段String'label'
listTypeInfo下拉选择数据源Object-
footer底部操作区(默认隐藏,使用插槽展示“保存”按钮)slot-
isKeyup单元格编辑是否开启键盘事件Booleanfalse
isShowFooterBtn是否显示保存按钮Booleanfalse
title表格左上标题String /slot-
isShowPagination是否显示分页(默认显示分页)Booleantrue
isTableColumnHidden是否开启合计行隐藏复选框/单选框Booleanfalse
isCopy是否允许双击单元格复制Booleanfalse
rowClickRadio是否开启点击整行选中单选框Booleantrue
columnSetting是否显示设置(隐藏/显示列)Booleanfalse
name与 columnSetting 配合使用标记隐藏/显示列唯一性Stringtitle
isRowSort是否开启行拖拽(row-key 需要设置)Booleanfalse
isTree是否开启Tree-table样式Booleanfalse
columnSetBind列设置按钮配置(继承el-button所有属性)Object-
----btnTxt按钮显示文字String'列设置'
----title点击按钮下拉显示titleString'列设置'
----sizeel-button的sizeString'default'
----iconel-button的iconString'Setting'

3、events 其他事件按照 el-table 直接使用(如 sort-change 排序事件)

事件名说明返回值
page-change当前页码当前选中的页码
save保存按钮编辑后的所有数据
handleEvent单个输入触发事件configEdit 中的 event 值和对应输入的 value 值
radioChange单选选中事件返回当前选中的整行数据
rowSort行拖拽排序后触发事件返回排序后的table数据

4、Methods 方法

事件名说明参数
clearSelection用于多选表格,清空用户的选择-
clearSort清空排序条件-
toggleRowSelection取消某一项选中项-
toggleAllSelection全部选中-