# Tree Table 树形表格

# 写在前面

此组件仅提供一个创建 TreeTable 的解决思路。它基于element-ui的 table 组件实现,通过el-tablerow-style方法,在里面判断元素是否需要隐藏或者显示,从而实现TreeTable的展开与收起。

并且本组件充分利用 vue 插槽的特性来方便用户自定义。

evel.js 里面,addAttrs 方法会给数据添加几个属性,treeTotable 会对数组扁平化。这些操作都不会破坏源数据,只是会新增属性。

# Props 说明

Attribute Description Type Default
data 原始展示数据 Array []
columns 列属性 Array []
defaultExpandAll 默认是否全部展开 Boolean false
defaultChildren 指定子树为节点对象的某个属性值 String children
indent 相邻级节点间的水平缩进,单位为像素 Number 50

任何 el-table 的属性都支持,例如borderfitsize或者@select@cell-click等方法。详情属性见el-table文档。


# 代码示例

<tree-table :data="data" :columns="columns" border>

# data(必填)

const data = [
  {
    name:'1'
    children: [
      {
        name: '1-1'
      },
      {
        name: '1-2'
      }
    ]
  },
  {
    name: `2`
  }
]

# columns(必填)

  • label: 显示在表头的文字
  • key: 对应 data 的 key。treeTable 将显示相应的 value
  • expand: true or false。若为 true,则在该列显示展开收起图标
  • checkbox: true or false。若为 true,则在该列显示checkbox
  • width: 每列的宽度,为一个数字(可选)。例如200
  • align: 对齐方式 left/center/right
  • header-align: 表头对齐方式 left/center/right
const columns = [
  {
    label: 'Checkbox',
    checkbox: true
  },
  {
    label: '',
    key: 'id',
    expand: true
  },
  {
    label: 'Event',
    key: 'event',
    width: 200,
    align: 'left'
  },
  {
    label: 'Scope',
    key: 'scope'
  }
]

树表组件将会根据 columns 的 key 属性生成具名插槽,如果你需要对列数据进行自定义,通过插槽即可实现

<template slot="your key" slot-scope="{scope}">
  <el-tag>level: {{ scope.row._level }}</el-tag>
  <el-tag>expand: {{ scope.row._expand }}</el-tag>
  <el-tag>select: {{ scope.row._select }}</el-tag>
</template>

# Events

目前提供了几个方法,不过只是beta版本,之后很可能会修改。

this.$refs.TreeTable.addChild(row, data) //添加子元素
this.$refs.TreeTable.addBrother(row, data) //添加兄弟元素
this.$refs.TreeTable.delete(row) //删除该元素

# 其他

如果有其他的需求,请参考el-table的 api 自行修改 index.vue