From 2e0d3fd0e4a8a1fddbc0b8693b6b6138bf52d08b Mon Sep 17 00:00:00 2001 From: Zenon Date: Wed, 24 Jan 2018 10:33:05 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9treeTable=E7=9B=B8=E5=85=B3?= =?UTF-8?q?=20(#422)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * 1.删除无用的属性 2.修改readme 3.修改eval.js，给后两个参数设置默认值 * update readme --- src/components/TreeTable/eval.js | 2 +- src/components/TreeTable/index.vue | 1 - src/components/TreeTable/readme.md | 37 +++++++++++++++++++----------- 3 files changed, 25 insertions(+), 15 deletions(-) diff --git a/src/components/TreeTable/eval.js b/src/components/TreeTable/eval.js index ffbe98aa..dfaac808 100644 --- a/src/components/TreeTable/eval.js +++ b/src/components/TreeTable/eval.js @@ -4,7 +4,7 @@ */ 'use strict' import Vue from 'vue' -export default function treeToArray(data, expandedAll, parent, level) { +export default function treeToArray(data, expandedAll, parent = null, level = null) { let tmp = [] Array.from(data).forEach(function(record) { if (record._expanded === undefined) { diff --git a/src/components/TreeTable/index.vue b/src/components/TreeTable/index.vue index 6146c76a..4ec22447 100644 --- a/src/components/TreeTable/index.vue +++ b/src/components/TreeTable/index.vue @@ -33,7 +33,6 @@ import treeToArray from './eval' export default { name: 'treeTable', props: { - a: 1, data: { type: [Array, Object], required: true diff --git a/src/components/TreeTable/readme.md b/src/components/TreeTable/readme.md index 2efa9b77..1db26006 100644 --- a/src/components/TreeTable/readme.md +++ b/src/components/TreeTable/readme.md @@ -1,8 +1,8 @@ ## 写在前面 -此组件仅提供一个创建TreeTable的解决方案 +此组件仅提供一个创建TreeTable的解决思路 ## prop说明 -### data +#### *data* **必填** 原始数据,要求是一个数组或者对象 @@ -35,13 +35,16 @@ } ``` -### columns +#### columns 列属性,要求是一个数组 - 1. text: 显示在表头 - 2. value: 对应data的key，treeTable将显示相应的value - 3. width: 每列的宽度，为一个数字 + 1. text: 显示在表头的文字 + 2. value: 对应data的key。treeTable将显示相应的value + 3. width: 每列的宽度，为一个数字(可选) + 如果你想要每个字段都有自定义的样式或者嵌套其他组件，columns可不提供，直接像在el-table一样写即可，如果没有自定义内容，提供columns将更加的便捷方便 + + 如果你有几个字段是需要自定义的，几个不需要，那么可以将不需要自定义的字段放入columns，将需要自定义的内容放入到slot中，详情见后文 ```javascript [{ value:string, @@ -54,25 +57,33 @@ }] ``` -### expandAll +#### expandAll 是否默认全部展开，boolean值，默认为false -### evalFunc +#### evalFunc 解析函数，function，非必须 - 如果不提供，将使用默认的evalFunc + 如果不提供，将使用默认的[evalFunc](./eval.js) - 如果提供了evalFunc,那么会用提供的evalFunc去解析data，并返回treeTable渲染所需要的值。如何编写一个evalFunc，请参考此目录下的*eval.js* + 如果提供了evalFunc,那么会用提供的evalFunc去解析data，并返回treeTable渲染所需要的值。如何编写一个evalFunc，请参考[*eval.js*](https://github.com/PanJiaChen/vue-element-admin/blob/master/src/components/TreeTable/eval.js)或[*customEval.js*](https://github.com/PanJiaChen/vue-element-admin/blob/master/src/views/example/table/treeTable/customEval.js) -### evalArgs +#### evalArgs 解析函数的参数，是一个数组 - **请注意，自定义的解析函数参数第一个为this.data，你不需要在evalArgs填写。** + **请注意，自定义的解析函数参数第一个为this.data，你不需要在evalArgs填写。** *this.data为需要解析的数据* 如你的解析函数需要的参数为`(this.data,1,2,3,4)`，那么你只需要将`[1,2,3,4]`赋值给`evalArgs`就可以了 + + 如果你的解析函数参数只有一个`(this.data)`,那么就可以不用填写evalArgs了 + + 具体可参考[*customEval.js*](https://github.com/PanJiaChen/vue-element-admin/blob/master/src/views/example/table/treeTable/customEval.js)的函数参数和[customTreeTable](https://github.com/PanJiaChen/vue-element-admin/blob/master/src/views/example/table/treeTable/customTreeTable.vue)的`evalArgs`属性值 ## slot - 请参考`customTreeTable` + 这是一个自定义列的插槽。 + + 默认情况下，treeTable只有一行行展示数据的功能。但是一般情况下，我们会要给行加上一个操作按钮或者根据当行数据展示不同的样式，这时我们就需要自定义列了。请参考[customTreeTable](https://github.com/PanJiaChen/vue-element-admin/blob/master/src/views/example/table/treeTable/customTreeTable.vue)，[实例效果](http://panjiachen.github.io/vue-element-admin/#/example/table/custom-tree-table) + + `slot`和`columns属性`可同时存在,columns里面的数据列会在slot自定义列的左边展示 ## 其他 如果有其他的需求，请参考[el-table](http://element-cn.eleme.io/#/en-US/component/table)的api自行修改index.vue