# Tree Table 树形表格

# 写在前面

此组件仅提供一个创建 TreeTable 的解决思路。它基于element-ui的 table 组件实现，通过el-table的row-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 的属性都支持，例如border、fit、size或者@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