项目作者: msidolphin

项目描述 :
A tree table component bases on Vue and ElementUI
高级语言: JavaScript
项目地址: git://github.com/msidolphin/element-ui-tree-table.git
创建时间: 2019-04-23T08:05:06Z
项目社区:https://github.com/msidolphin/element-ui-tree-table

开源协议:MIT License

下载


element-ui-tree-table

扩展ElementUI表格组件,支持树状结构

安装

  1. npm install element-ui-tree-table -S

使用方式

项目依赖于Element-UI,您需要先进行引入

引入

  1. import TreeTableComponent from 'element-ui-tree-table'
  2. import 'element-ui-tree-table/dist/index.css'
  3. Vue.use(TreeTableComponent, {
  4. prefix: 'i' // 可选
  5. })

使用

测试数据

  1. <template>
  2. <div id="app">
  3. <i-tree-table height="600px" id-key="rowKey" :columns="columns"
  4. @select="onSelect"
  5. @trigger="onTrigger"
  6. :data="data" border>
  7. <el-table-column label="负责人" prop="leader"></el-table-column>
  8. <el-table-column label="创建时间" prop="createTime"></el-table-column>
  9. <el-table-column label="经验要求" prop="expr">
  10. <template slot-scope="scope">
  11. <span v-if="scope.row.expr">{{scope.row.expr}}</span>
  12. <span v-else>————</span>
  13. </template>
  14. </el-table-column>
  15. <el-table-column label="发布天数" prop="date"></el-table-column>
  16. </i-tree-table>
  17. <br/>
  18. <el-button type="primary" size="small" @click="add">增加一行</el-button>
  19. </div>
  20. </template>
  21. <script>
  22. import data from './components/data'
  23. import TreeTable from './components/tree-table'
  24. export default {
  25. name: 'App',
  26. components: {
  27. TreeTable
  28. },
  29. data () {
  30. return {
  31. data,
  32. columns: [{
  33. type: 'index',
  34. align: 'center'
  35. }, {
  36. type: 'selection',
  37. align: 'center'
  38. }, {
  39. label: '职位名称',
  40. prop: 'name'
  41. }],
  42. id: 1000
  43. }
  44. },
  45. methods: {
  46. add () {
  47. this.data.push({
  48. rowKey: this.id++,
  49. name: '新增行',
  50. leader: '管理员',
  51. $expanded: true,
  52. createTime: '2019-07-24',
  53. expr: '',
  54. date: '1天'
  55. })
  56. },
  57. onSelect (selection) {
  58. console.log(selection)
  59. },
  60. onTrigger (row, expanded) {
  61. /**
  62. * 在这里可以保留折叠状态
  63. * 也可以设置reserve-expaned属性为true保留状态 但是你不能够设置默认值,设置了默认值的行将不受控,因为* 组件肯定是选择用户传入$expaned属性为准
  64. * 所以推荐的做法是监听trigger事件
  65. */
  66. row.$expanded = expanded
  67. }
  68. }
  69. }
  70. </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文档