element-ui-tree-table
扩展ElementUI表格组件,支持树状结构
安装
npm install element-ui-tree-table -S
使用方式
项目依赖于Element-UI,您需要先进行引入
引入
Vue
使用
<template> <div id="app"> <i-tree-table height="600px" id-key="rowKey" :columns="columns" @select="onSelect" @trigger="onTrigger" :data="data" border> <el-table-column label="负责人" prop="leader"/> <el-table-column label="创建时间" prop="createTime"/> <el-table-column label="经验要求" prop="expr"> <template slot-scope="scope"> <span v-if="scope.row.expr">{{scope.row.expr}}</span> <span v-else>————</span> </template> </el-table-column> <el-table-column label="发布天数" prop="date"/> </i-tree-table> <br/> <el-button type="primary" size="small" @click="add">增加一行</el-button> </div></template> <script>import data from './components/data'import TreeTable from './components/tree-table'export default { name: 'App', components: { TreeTable }, data () { return { data, columns: [{ type: 'index', align: 'center' }, { type: 'selection', align: 'center' }, { label: '职位名称', prop: 'name' }], id: 1000 } }, methods: { add () { this.data.push({ rowKey: this.id++, name: '新增行', leader: '管理员', $expanded: true, createTime: '2019-07-24', expr: '', date: '1天' }) }, onSelect (selection) { console.log(selection) }, onTrigger (row, expanded) { /** * 在这里可以保留折叠状态 * 也可以设置reserve-expaned属性为true保留状态 但是你不能够设置默认值,设置了默认值的行将不受控,因为* 组件肯定是选择用户传入$expaned属性为准 * 所以推荐的做法是监听trigger事件 */ row.$expanded = expanded } }}</script>
配置项
属性 | 类型 | 说明 | 默认值 |
---|---|---|---|
data | Array | 数据源, 要求默认指定一个rowKey属性,唯一标识该行 | - |
id-key | String | 数据源唯一索引 | rowKey |
columns | Array | 配置索引列,选择列和展开列 | - |
icon | String | 展开图标 | el-icon-caret-right |
trigger-class | String | 展开按钮类 | - |
reserve-expaned | Boolean | 是否保留展开状态,建议此属性为true时不要设置默认展开,保留展开状态可以通过监听trigger实现 | - |
原表格配置项 | - | 参考element-ui文档 | - |
columns配置项
注意:
- 第一个type不为index和selection的元素将被视为展开按钮放置列
- 只能有一个展开列,多余的会忽略
展开列配置
属性 | 类型 | 说明 | 可选值 |
---|---|---|---|
label | String | 显示的标题 | - |
prop | String | 对应列内容的字段名,也可以使用 property 属性 | - |
align | String | 对齐方式 | left/center/right |
width | String | 对应列的宽度 | - |
fixed | String, Boolean | 列是否固定在左侧或者右侧,true 表示固定在左侧 | |
render-header | Function(h, { column, $index }) | 列标题 Label 区域渲染使用的 Function | |
class-name | String | 列的 className | |
label-class-name | String | 当前列标题的自定义类名 | |
show-overflow-tooltip | Boolean | 当内容过长被隐藏时显示 tooltip | |
min-width | String | 对应列的最小宽度,与 width 的区别是 width 是固定的,min-width 会把剩余宽度按比例分配给设置了 min-width 的列 | |
header-align | String | 表头对齐方式,若不设置该项,则使用表格的对齐方式 | left/center/right |
resizable | Boolean | 对应列是否可以通过拖动改变宽度(需要设置 border 属性为真) |
普通列配置
属性 | 类型 | 说明 | 可选值 |
---|---|---|---|
type | String | 对应列的类型,如果设置了 selection 则显示多选框;如果设置了 index 则显示该行的索引 | selection/index |
label | String | 显示的标题 | - |
prop | String | 对应列内容的字段名,也可以使用 property 属性 | - |
align | String | 对齐方式 | left/center/right |
width | String | 对应列的宽度 | - |
fixed | String, Boolean | 列是否固定在左侧或者右侧,true 表示固定在左侧 | |
render-header | Function(h, { column, $index }) | 列标题 Label 区域渲染使用的 Function | |
class-name | String | 列的 className | |
label-class-name | String | 当前列标题的自定义类名 | |
selectable | Function(row, index) | 仅对 type=selection 的列有效,类型为 Function,Function 的返回值用来决定这一行的 CheckBox 是否可以勾选 | |
show-overflow-tooltip | Boolean | 当内容过长被隐藏时显示 tooltip | |
min-width | String | 对应列的最小宽度,与 width 的区别是 width 是固定的,min-width 会把剩余宽度按比例分配给设置了 min-width 的列 | |
header-align | String | 表头对齐方式,若不设置该项,则使用表格的对齐方式 | left/center/right |
resizable | Boolean | 对应列是否可以通过拖动改变宽度(需要设置 border 属性为真) |
事件
事件名 | 作用 | 参数 |
---|---|---|
trigger | 展开状态改变时触发,一般用作保存状态 | (data数据源节点,展开状态) |
方法
方法名 | 作用 | 参数 |
---|---|---|
expandAll | 展开所有 | - |
collapseAll | 收起所有 | - |
参考element-ui文档