下拉树控件

1. 控件效果
2. 基本属性
3. 高级
4. 校验
5. 性能优先

1. 控件效果

2. 基本属性

2.1控件名、可用、可见

详细请查看控件通用属性(文本控件)

2.2 控件值

给下拉树赋默认值，根据下拉树返回值的不同，默认值的输入格式不相同，必须与返回值的格式保持一致，下拉树默认值设置请查看下拉树默认值设置

3. 高级

3.1 数据字典

1)自动构建

自动构建树能够根据数据自动构建出下拉树，无需一层一层定义数据，但是其必须使用树数据集来构建。

2)分层构建

不是所有的数据都能自动构建出下拉树，因此需要分层构建。

层次1

层次1通过数据字典来定义下拉框的实际值与显示值。

层次2

层次2的数据一般会根据层次1的数据进行过滤，因此需要定义成数据集，然后通过数据查询返回数据集定义的列。一般数据集定义成：

SELECT 字段 FROM 表名 WHERE 层次1的字段 = '${layer1}'

注：layer1表示取层次1节点的值，若在层次3中调用，则是SELECT 字段 FROM 表名 WHERE 层次2的字段 = '${layer2}'依次类推。

3.2 多选

即确定下拉树类型，默认不勾选，即为单选下拉树，勾选多选即为多选下拉树。

3.3 异步加载

勾选即为使用异步加载，下拉树中首次只加载父节点的数据，当点击父节点前面的加号后才会重新与数据库交互取出对应的子节点数据，适用于数据量大的情况。

去掉勾选表示下拉树中的数据是一次性全部取出，适用于数据量小的情况。

3.4 结果返回叶子节点

勾选结果返回叶子节点，即下拉树文本框中返回该节点最后一层的所有数据，不勾选即表示选中什么则返回什么，如下表：

选项	勾选叶子节点	不勾选叶子节点
选中a	返回值：a1,a2,a3	返回值：a

注：结果返回叶子节点只对多选下拉树起作用，结果返回叶子节点返回数组类型数据。

3.5 结果返回完整层次路径

1)结果不返回完整层次路径

下拉树是一种有层次结构的控件，不勾选结果返回完整层次路径选项，下拉树返回选中的值，根据是否结果返回叶子节点确定最终选中的值，如下图，勾选结果返回叶子节点，返回结果效果如下，查询出来的下拉树的值返回的是所有叶子节点数据，并且不是完整层次路径值，而是叶子节点的实际值：

回到下拉树属性设置面板，去掉结果返回叶子节点前面的勾选，再次预览查看效果如下图，下拉树查询出来的值是选中节点的实际值，没有返回叶子节点，且不是完整层次路径值，选中什么返回什么：

2)结果返回完整层次路径

在下拉树属性面板勾选结果返回完整层次路径前面的勾选，并选中结果返回叶子节点，预览查看模板，选中人力资源部选项的时候，可以看到下拉树返回的值为所有叶子节点的完整路径值，不再是叶子节点的实际值，如下图：

仍然勾选结果返回完整层次路径前面的勾选，去掉结果返回叶子节点前面的勾选，预览查看模板，可以看到下拉树返回值返回的为选中项的完整路径值，并不是叶子节点的路径，如下图：

4. 校验

4.1 允许为空

4.2 允许直接编辑

4.3 允许自定义值

5. 性能优先

下拉树在分层构建的时候，还是会去找子节点，导致性能很慢。

下拉树会去找其子节点以便来构建树，但是当选择“分层构建”这种方式的时候，是不需要有这步的。是可以直接根据设置的层级来构建树的，因此提供“性能优先”选项。

当构建方式选择“分层构建”时，多一个“性能优先”的选项，如下图：

注：默认不选中“性能优先”

注：使用该选项时，由于不找子节点，那如果有层目录下没有子节点，预先是不知道的，显示的时候仍会是“+”，点开当然是没有数据的，如下图：

下拉树的详细使用示例清查下拉树控件自动构建示例和下拉树控件分层构建示例

下拉树相关链接：

主题：

标签：已验证