下拉框

2025年1月14日大约 4 分钟

下拉组件可通过手动录入或选择数据资源的方式生成下拉选项，下拉框组件主要包含三个部分：标题、选择框和按钮。

① 标题区：
- 标题：设置标题区文本内容，是否展示和展示宽度设置参见组件/标签。
② 选择区：设置该组件的查询值。
- 配置：设置下拉框的选择行为。
  - 多选：勾选多选后，下拉框组件允许选择多个值；否则只允许选择一个。
  - 过滤：勾选过滤后，下拉框内允许输入文本来对下拉列表进行数据过滤，方便用户选择。
  - 允许清空：勾选允许清空后，当下拉框存在已选择的值时，选择框内会出现清空按钮，点击即可清空已选择值。
- 默认值：设置组件的选择的默认值，可选择下拉列表中的任意项为默认值，亦可选择某个全局参数为默认值。
  - 当想要使用某个全局参数为查询默认值时，可勾选全局参数，在下方出现的全局参数下拉列表中选择想要实用的全局参数即可。
- 提示：设置文本框被清空时的展示值（相当于 placeholder）。
③ 下拉按钮：
- 按钮：设置下拉按钮区域是否展示，勾选时显示下拉按钮，取消勾选时此区域将不在设计器内显示。

数据配置

下拉框需要完成数据配置后才能生成下拉列表，完成数据配置的下拉框方可正常使用。下拉框的数据配置需要选中下拉框后，在右侧的高级选项卡中进行配置，配置的方式分为数据资源和手动录入两种。

数据资源

设置数据资源配置方式。
设置数据资源。
设置用于展示和联动的成员字段（选择的字段值会作为下拉选项的 label 和 value）。
- （① 删除）：删除已选择的成员字段。
- ② 字段名：展示当前已选择的成员字段，点击字段可以弹出当前数据资源的字段列表供用户选择，用以替换当前字段。
- （③ 更多）：点击打开更多操作。
  - 筛选：打开筛选器弹窗，为当前字段添添加筛选规则，确定后将当前字段追加到过滤中。
  - 删除：从成员字段中删除当前字段。
设置过滤字段和过滤条件。
- （① 删除）：删除已添加的过滤字段。
- ② 字段名：展示当前已选择的过滤字段，点击字段可以弹出当前数据资源的字段列表供用户选择，用以替换当前字段。
- （③ 更多）：点击打开更多操作。
  - 筛选：打开筛选器弹窗，为当前字段添添加筛选规则。
  - 删除：从过滤字段中删除当前字段。
- ④ 点击添加：点击打开当前数据资源的字段列表，选择字段添加到过滤字段中，在打开的列表中点击已选择字段可从过滤字段中将其删除。

提示

筛选规则的添加详情请参见用户指南/卡片设计器/筛选器。

手动录入

设置数据资源配置方式。
设置自定义选项。
- （① 添加）：新增自定义选项
- ② 配置自定义选项：设置自定义选项的展示值和查询值（即 label 和 value）。
- （③ 删除）：删除当前自定义选项

数据配置演示：

提示

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

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