下拉框

1. 组件概述

下拉框是一个数据输入组件，用于从预设的选项列表中选择一个或多个值。用户点击下拉框后会展开选项列表，可以通过点击选择所需选项。下拉框是最常用的选项选择组件，适用于各种需要从固定选项中选择的场景，如选择学科、难度级别、AI 模型类型等。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：选择 AI 对话模型。在多模型对话应用中，用户通过下拉框选择要使用的 AI 模型（如 GPT-4、Claude 等）。配置选项数据，设置绑定变量为”model”，开启”可检索”方便用户快速找到目标模型。
• 场景二：多标签筛选。在学习资源库中，用户需要选择多个知识点标签来筛选相关内容。开启”可多选”，配置知识点选项，开启”可全选”方便一键选中所有标签，在”值变化”事件中调用工作流获取筛选结果。

加载中...

查看 JSON

复制 JSON

3. 功能配置

基础

配置折叠组

配置项	说明
绑定变量	组件的变量名，用户选择的值会以此变量名存储。其他组件可以绑定此变量来显示其值，调用工作流时此变量的值会传递给工作流。
标题	下拉框左侧显示的标签文字，用于说明该选择项的用途，如”选择学科”、“难度级别”。
可清除	开启后，下拉框右侧显示清除按钮，点击可一键清空已选内容。适用于允许用户取消选择的场景。
可检索	开启后，下拉框支持输入关键词搜索选项。当选项较多时建议开启，方便用户快速定位目标选项。
可多选	开启后，用户可以同时选择多个选项。适用于标签选择、多条件筛选等需要多选的场景。开启后会显示以下子配置项： - 单行显示选中值：开启后，多个选中值在一行内显示，超出部分隐藏。适用于空间有限的场景。 - 标签展示数：设置选中标签的最大展示数量，超出数量后以收纳浮层的方式展示，不设置则全部展示。
可全选	仅在开启”可多选”后显示。开启后，选项列表顶部会出现”全选”按钮，方便用户一键选中所有选项。开启后可配置： - 默认全选：页面加载时自动选中所有选项。 - 选项文案：自定义全选按钮的文字，默认为”全选”。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置简短的帮助说明。
控件提示	在下拉框旁边显示一个小问号图标，鼠标悬停时弹出提示内容。
占位提示	下拉框未选择时显示的灰色提示文字，引导用户操作。如”请选择学科”。
描述	显示在下拉框下方的浅色说明文字，用于补充解释该配置项的用途或选择要求。

选项折叠组

配置项	说明
数据	配置下拉框的选项列表。可以手动添加静态选项（每个选项包含显示文本和对应值），也可以通过接口动态获取选项数据。

事件折叠组

配置项	说明
添加事件	支持”值变化”、“获取焦点”、“失去焦点”三种触发事件。最常用的是”值变化”事件，当用户选择不同选项时触发，可配合”调用工作流”动作实现选择后自动获取相关数据或触发 AI 处理。

高级

配置折叠组

配置项	说明
选项值检查	开启后，当选项值未匹配到当前选项列表中的选项时，选项文本会飘红显示。适用于需要严格校验选项有效性的场景。
虚拟列表阈值	当选项数量超过设定的阈值后，会开启虚拟列表以优化性能。适用于选项数量非常多（如数百个）的场景，可以显著提升下拉框的响应速度。
选项高度	开启虚拟列表时每个选项的高度（像素）。需要配合虚拟列表阈值使用，确保虚拟列表正确计算滚动位置。

状态折叠组

配置项	说明
可见	控制组件是否显示。默认可见。
隐藏	控制组件是否隐藏。与”可见”相反。
禁用	控制组件是否禁用（变灰且不可操作）。可以设置为始终禁用，或根据条件动态控制。
静态展示	开启后，下拉框变为只读的纯文本展示模式，不可编辑。适用于详情页或确认页面。
隐藏时删除字段	开启后，当该组件被隐藏时，其值会从表单数据中删除。适用于条件显示的字段，避免提交无关数据。

校验折叠组

配置项	说明
校验规则	配置下拉框的校验规则，如必填等。当用户未按要求选择时，会显示相应的错误提示。