ref-tree-fs v2.1.8

参照树形 RefTree

何时使用

单选多选树形参照

如何使用

$ ynpm install ref-tree --save

引入

import RefTreeBaseUI from 'ref-tree';
或者
import { RefTreeWithInput } from 'ref-tree';

样式

import 'ref-tree/lib/index.css';

代码演示

分类

RefTreeBaseUI（默认）

树参照通用ui

RefTreeWithInput

 带文本框的树参照弹出窗。

API

RefTreeBaseUI

RefTreeWithInput

RefTreeWithInput可以使用RefTreeBaseUI的参数（除了showModal），还可以使用以下参数。

注意事项

参数解析

• 1.input框的展示值

  • 1.1 input框的初始值，只从value的refname中获取
  • 1.2 参照进行保存操作之后（点击参照确认按钮），input框展示由inputDisplay来决定

• 2.value、inputDisplay、 displayField

  2.1 value和inputDisplay是针对input框来说。

  2.2 value格式可以是'{"refname":"初级-T1","refpk":"level1"}'或者数组object1,object2...。refname字段不可变，refpk是该数据键，要求具有唯一性；object中应包含数据项具体信息。

  2.3 inputDisplay确定input中显示内容的格式，displayField过滤列表显示内容的格式。inputDisplay和displayField中使用到的字段必须是filterData,matchData和treeData数据项中都含有的字段。

  inputDisplay和displayField具体使用参考demo3

  注意：value格式是'{"refname":"初级-T1","refpk":"level1"}'，inputDisplay只包含refname或者refpk

• 3.value、valueFiled

  value初始化input框值，是input需要使用的数据，要求如上。 valueFiled指定数据源的键，要求具有唯一性。 因此value中refpk指定值应与valueFiled取值一致。

  注意，在多选情况下，value是字符串'{"refname":"初级-T1","refpk":"level1"}'格式，那么valueFiled只能指定是refpk；value是数组，valueField可以是其他字段 具体使用参考demo3

• 4.value、matchData

  value初始化input框值，matchData是指定参照中选中的节点。具体参照demo3，value与matchData并不完全相同

  • 4.1 如果value有值matchData为空，那么input有值但是参照无选中数据；
  • 4.2 反之value空值matchData有值，那么input为空但是参照有选中数据；
  • 4.3 如果value与matchData都有值，但是不匹配，树中选中数据按照matchData。

更新日志