树形下拉

2025年1月14日大约 4 分钟

树形下拉组件允许创建层级结构（如省、市、区结构）的数据进行筛选，通过配置数据资源的方式生成下拉选项，下拉框组件主要包含三个部分：标题、选择框和按钮。

① 标题区：
- 标题：设置标题区文本内容，是否展示和展示宽度设置参见组件/标签。
② 选择区：设置该组件的查询值。
- 勾选策略：设置树形下拉列表中可被选中的策略。
  - 叶节点：只有最里边的一级（叶级）节点允许选中。
  - 独立：所有节点都允许选中。
- 配置：设置树形下拉的选择行为。
  - 多选：勾选多选后，树形下拉组件允许选择多个值；否则只允许选择一个。
  - 懒加载：当下拉选项过多时，勾选懒加载可以显著提升下拉选项的渲染速度（如配置了省市区三级下拉，开启懒加载后下拉树就可以快速显示出来）。
  - 过滤：勾选过滤后，树形下拉框内允许输入文本来对下拉列表进行数据过滤，方便用户选择。
- 默认值：设置组件的选择的默认值，可选择下拉列表中的任意项为默认值，亦可选择某个全局参数为默认值。
  - 当想要使用某个全局参数为查询默认值时，可勾选全局参数，在下方出现的全局参数下拉列表中选择想要实用的全局参数即可。
- 提示：设置文本框被清空时的展示值（相当于 placeholder）。
③ 下拉按钮：
- 按钮：设置下拉按钮区域是否展示，勾选时显示下拉按钮，取消勾选时此区域将不在设计器内显示。

数据配置

设置数据资源。
设置用于展示和联动的成员字段。
- （① 删除）：删除已选择的成员字段。
- ② 字段名：展示当前已选择的成员字段，点击字段可以弹出当前数据资源的字段列表供用户选择，用以替换当前字段。
- （③ 更多）：点击打开更多操作。
  - 筛选：打开筛选器弹窗，为当前字段添添加筛选规则，确定后将当前字段追加到成员过滤中。
  - 删除：从成员字段中删除当前字段。
- ④ 添加按钮：点击打开当前数据资源的字段列表，选择字段添加到成员字段中，在打开的列表中点击已选择字段可从成员字段中将其删除。
提示
根据选择的成员字段，生成层级结构数据的方式有以下两种：
- id-pid 形式：数据存在明确的通过 pid 或 parentid 来定义的父子关系，此类数据选择了 id、pid 字段后可以选择第三个成员字段作为展示值。
- 自定义层级：对父子关系没有字段明确规定，可选择任意维度字段，系统根据选择字段的顺序生成层级结构。
设置过滤字段和过滤条件。
- （① 删除）：删除已添加的过滤字段。
- ② 字段名：展示当前已选择的过滤字段，点击字段可以弹出当前数据资源的字段列表供用户选择，用以替换当前字段。
- （③ 更多）：点击打开更多操作。
  - 筛选：打开筛选器弹窗，为当前字段添添加筛选规则。
  - 删除：从过滤字段中删除当前字段。
- ④ 点击添加：点击打开当前数据资源的字段列表，选择字段添加到过滤字段中，在打开的列表中点击已选择字段可从过滤字段中将其删除。

数据配置方式：

提示

案例中 id-pid 结构类数据时联动规则为提前配置；而切换为层级结构后图表和树形下拉框为同一数据资源，因此自动联动规则生效，演示了树形下拉组件对省份这个维度的筛选。

而联动规则如何配置，请移步高级配置/资源联动。