下拉树控件

• 使用自动构建方法构建下拉树时，树数据集根节点的父节点可以不为空

• 参数控件「异步加载」修改名称为「异步展开树节点」；设置默认值之后，异步加载逻辑统一，详情见 2.1.2 节

• 填报控件「异步加载」修改名称为「异步展开树节点」；设置默认值之后，异步加载逻辑统一，详情见 2.1.1 节

• 新增「返回值类型」设置项，详情见 2.1 节属性表格

• 默认值设置方式优化，不用填写完整路径即可设置默认值，详情见 2.1.2 节
  

有对应关系的一列或两列字段，树关系完整，支持存在多个根节点。

注：11.0.6 之前根节点的父节点必须为空。

有对应关系的多列字段，sql中需要用treelayer函数进行过滤。

可以定义下拉树实际值与显示值，有 3 种构建方式，自动构建、普通分层构建、极速分层构建

1）自动构建：根据树数据集层级关系自动构建出下拉树，无需一层一层定义数据。详细示例可参考：下拉树自动构建

2）普通分层构建：通过 数据字典 一层一层定义下拉树，需要数据集中定义一些 layer 参数配合完成，将上一层的值作为参数值，过滤下一层的数据。详细示例可参考：下拉树普通分层构建

• 普通分层构建时，提供「性能优先」选项，勾选后会提高加载效率，默认不勾选。如下图所示：
  

    勾选后，当有层目录下没有子节点，显示的时候仍会是 + ，点开无数据项，如下图所示：

3）极速分层构建：通过「数据集 」来定义下拉树的层级，相比「普通分层构建」，不需要 layer 参数配合，而是将数据按分类排列，每一层绑定数据列即可。详细示例可参考：下拉树极速分层构建

注：不支持通过设置单元格字体大小和颜色来调整数据字典选项的字体大小和颜色。

勾选后，填报时可选择下拉树的多个选项；不勾选，填报时只可一个选项。默认不勾选

异步展开树节点

注：11.0.7 之前名称为异步加载

节点加载逻辑，会影响性能，默认勾选。

勾选后，展开选项时只加载父节点的数据，所有子节点默认不展开，适用于数据量大的情况。当控件有默认值时，默认值节点展开并选中，其他节点不展开。

不勾选，展开选项时所有子节点一次性展开，适用于数据量小的情况。当控件有默认值时，所有子节点一次性展开并选中默认值节点。

多选时，选择父节点后，是否会自动选择子节点。默认勾选

勾选后，勾选父节点时自动勾选子节点

不勾选，当勾选父节点时不自动勾选子节点

注：「结果返回叶子节点」是多选下拉树的功能设置项，单选下拉树不受影响。

下拉树是一种有层次结构的控件，每个最末端的叶子节点都有其完整的层次路径。「结果返回完整路径」即选择值后，要不要返回其完整的层次路径，返回值为数组类型的数据

勾选后，返回完整路径，如选择北京，返回值为：华北,北京,北京

不勾选后，只返回叶子节点，如上选择北京，返回值为：北京

勾选「结果返回完整层次路径」后，返回值类型已确定，所以对应情况下不会有此设置项。

1）数组：返回值类型是数组型，例如：勾选三个值，返回值为：["值 1","值 2","值 3"]

2）字符串：返回值类型为字符串，需要定义分隔符、开始符和结束符，即将勾选的多个值根据分隔符拼接成一个字符串。例如：在输入法为英文的状态下，将分隔符，开始符和结束符分别定义成逗号，单引号和单引号，则返回值为：'值 1,值 2,值 3'

是否允许用户直接输入值，勾选后，用户可以直接输入值，实现模糊搜索，默认勾选

注：此功能不支持移动端

是否允许用户输入不包含在下拉树选项中的值

• 勾选后，允许输入

• 不勾选「允许自定义值」和「多选」，不允许输入不包含在下拉树选项中的值，当输入值包含在下拉树选项中时，下拉树框不会自动清除输入值，并会弹出提示框：值不在下拉列表内

• 不勾选「允许自定义值」，勾选「多选」，不允许输入不包含在下拉树选项中的值，当输入值包含在下拉树选项中时，下拉树框会自动清除输入值，并会弹出提示框：值不在下拉列表内

控件初始化时的默认值，可以为数据字典时绑定的实际值，也可以为显示值。支持字符串、字段、公式，默认为空

注：11.0.7 之前版本下拉树默认值必须写节点实际值的完整路径，11.0.7 及以后版本，新增 TREEDEFAULTPATH 函数，不用填写完整路径即可设置默认值。

1）字符串：字符文字，例如：要选中北京，写华北,北京,北京

多个值时，字父节点之间用,隔开，多个值之间用 ;隔开，例如选中北京和上海，写华北.北京,北京;华东,上海,上海

2）字段：数据集字段，数据集包括模板数据集和服务器数据集。例如：数据集 ds1 的地区字段

注：多选下拉树不支持使用字段来实现全选功能，如有此需求可参考 下拉树控件默认全选 实现。

若字段值符合多个值写法，则会多选

3）公式：设计器支持的公式，例如： A1 单元格的值，或者 =[[1,11,111],[1,11,112]]

若公式对应的值符合多个值写法，则会多选

可以定义下拉树实际值与显示值，有 3 种构建方式，自动构建、普通分层构建、极速分层构建

1）自动构建：根据树数据集层级关系自动构建出下拉树，无需一层一层定义数据。详细示例可参考：下拉树自动构建

2）普通分层构建：通过 数据字典 一层一层定义下拉树，需要数据集中定义一些 layer 参数配合完成，将上一层的值作为参数值，过滤下一层的数据。详细示例可参考：下拉树普通分层构建

• 普通分层构建时，提供「性能优先」选项，勾选后会提高加载效率，默认不勾选。如下图所示：
  

    勾选后，当有层目录下没有子节点，显示的时候仍会是“+”，点开无数据项，如下图所示：

3）极速分层构建：通过「数据集 」来定义下拉树的层级，相比「普通分层构建」，不需要 layer 参数配合，而是将数据按分类排列，每一层绑定数据列即可。详细示例可参考：下拉树极速分层构建

被选中的，显示在控件框中选项的字体大小，默认为 12 。

注：下拉选项中的文字大小不随此处的字体大小变化。

勾选后，填报时可选择下拉树的多个选项；不勾选，填报时只可选择下拉树的一个选项。默认不勾选

异步展开树节点

注：11.0.6 之前名称为异步加载

节点加载逻辑，会影响性能，默认勾选。

注：自动构建方式构建的下拉树不支持异步展开树节点

勾选后，展开选项时只加载父节点的数据，所有子节点默认不展开，适用于数据量大的情况。当控件有默认值时，默认值节点展开并选中，其他节点不展开。

不勾选，展开选项时所有子节点一次性展开，适用于数据量小的情况。当控件有默认值时，所有子节点一次性展开并选中默认值节点。

勾选后，勾选父节点时自动勾选子节点；

不勾选，当勾选父节点时不自动勾选子节点

注：「结果返回叶子节点」是多选下拉树的功能设置项，单选下拉树不受影响。

下拉树是一种有层次结构的控件，每个最末端的叶子节点都有其完整的层次路径。结果返回完整路径即选择值后，要不要返回其完整的层次路径，返回值为数组类型的数据

勾选后，返回完整路径，如选择北京，返回值为：华北,北京,北京

不勾选后，只返回叶子节点，如上选择北京，返回值为：北京

返回值类型

注：此项为11.0.7 新增

勾选「多选」和不勾选「结果返回完整层次路径」后才有此设置项。用来设置多选下拉树返回值的格式，分为数组和字符串两种。

勾选「结果返回完整层次路径」后，返回值类型已确定，所以对应情况下不会有此设置项。

1）数组：返回值类型是数组型，例如：勾选三个值，返回值为：["值 1","值 2","值 3"]

2）字符串：返回值类型为字符串，需要定义分隔符、开始符和结束符，即将勾选的多个值根据分隔符拼接成一个字符串。例如：在输入法为英文的状态下，将分隔符，开始符和结束符分别定义成逗号，单引号和单引号，则返回值为：'值 1,值 2,值 3'

是否允许用户直接输入值，勾选后，用户可以直接输入值，实现模糊搜索，默认勾选

注：此功能不支持移动端。

是否允许用户输入不包含在下拉树选项中的值

• 勾选后，允许输入

• 不勾选「允许自定义值」和「多选」，不允许输入不包含在下拉树选项中的值，当输入值包含在下拉树选项中时，下拉树框不会自动清除输入值，并会弹出提示框：值不在下拉列表内

• 不勾选「允许自定义值」，勾选「多选」，不允许输入不包含在下拉树选项中的值，当输入值包含在下拉树选项中时，下拉树框会自动清除输入值，并会弹出提示框：值不在下拉列表内

场景描述：

下拉树中分别有 地区，省份，城市 指标，可以实现同时选择查询出多个城市的数据

参考文档：

多选下拉树实现多值查询

场景描述：

数据库中有 3 个级别的数据，分别是地区，城市，以及客户名称，可以同下拉树控件实现同时选择查询出华东地区下所有公司以及北京的某个公司的数据

参考文档：

多选下拉树实现不同级别之间的查询

场景描述：

下拉树控件可以设置默认值

参考文档：

场景描述：

下拉树控件可以设置默认全选

参考文档：

下拉树控件默认全选