1.0.3 • Published 5 years ago

element-ui-tree-table v1.0.3

Weekly downloads
17
License
-
Repository
github
Last release
5 years ago

element-ui-tree-table

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

安装

npm install element-ui-tree-table -S

使用方式

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

引入

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

使用

测试数据

<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>

配置项

属性类型说明默认值
dataArray数据源, 要求默认指定一个rowKey属性,唯一标识该行-
id-keyString数据源唯一索引rowKey
columnsArray配置索引列,选择列和展开列-
iconString展开图标el-icon-caret-right-
trigger-classString展开按钮类-
reserve-expanedBoolean是否保留展开状态,建议此属性为true时不要设置默认展开,保留展开状态可以通过监听trigger实现-
原表格配置项-参考element-ui文档-

columns配置项

注意:

  • 第一个type不为index和selection的元素将被视为展开按钮放置列
  • 只能有一个展开列,多余的会忽略

展开列配置

属性类型说明可选值
labelString显示的标题-
propString对应列内容的字段名,也可以使用 property 属性-
alignString对齐方式left/center/right
widthString对应列的宽度-
fixedString, Boolean列是否固定在左侧或者右侧,true 表示固定在左侧
render-headerFunction(h, { column, $index })列标题 Label 区域渲染使用的 Function
class-nameString列的 className
label-class-nameString当前列标题的自定义类名
show-overflow-tooltipBoolean当内容过长被隐藏时显示 tooltip
min-widthString对应列的最小宽度,与 width 的区别是 width 是固定的,min-width 会把剩余宽度按比例分配给设置了 min-width 的列
header-alignString表头对齐方式,若不设置该项,则使用表格的对齐方式left/center/right
resizableBoolean对应列是否可以通过拖动改变宽度(需要设置 border 属性为真)

普通列配置

属性类型说明可选值
typeString对应列的类型,如果设置了 selection 则显示多选框;如果设置了 index 则显示该行的索引selection/index
labelString显示的标题-
propString对应列内容的字段名,也可以使用 property 属性-
alignString对齐方式left/center/right
widthString对应列的宽度-
fixedString, Boolean列是否固定在左侧或者右侧,true 表示固定在左侧
render-headerFunction(h, { column, $index })列标题 Label 区域渲染使用的 Function
class-nameString列的 className
label-class-nameString当前列标题的自定义类名
selectableFunction(row, index)仅对 type=selection 的列有效,类型为 Function,Function 的返回值用来决定这一行的 CheckBox 是否可以勾选
show-overflow-tooltipBoolean当内容过长被隐藏时显示 tooltip
min-widthString对应列的最小宽度,与 width 的区别是 width 是固定的,min-width 会把剩余宽度按比例分配给设置了 min-width 的列
header-alignString表头对齐方式,若不设置该项,则使用表格的对齐方式left/center/right
resizableBoolean对应列是否可以通过拖动改变宽度(需要设置 border 属性为真)

事件

事件名作用参数
trigger展开状态改变时触发,一般用作保存状态(data数据源节点,展开状态)

方法

方法名作用参数
expandAll展开所有-
collapseAll收起所有-

参考element-ui文档

1.0.3

5 years ago

1.0.2

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago