列表选择

1. 组件概述

列表选择是一个数据输入组件，用于从一组选项中选择一个或多个值。与下拉框不同，列表选择会将所有选项以列表项的形式直接展示在页面上，用户可以一目了然地看到所有可选内容。这种展示方式更加直观，特别适合选项数量较少（通常 2-6 个）且需要让用户快速做出选择的场景。列表选择还支持为每个选项配置图片或自定义显示模板，可以展示比普通下拉框更丰富的信息。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：AI 对话风格选择。在搭建 AI 聊天助手时，让用户选择对话风格（如”专业严谨”、“轻松幽默”、“简洁明了”）。使用列表选择可以直观展示各风格的特点，用户点击后将选中的风格传递给工作流，AI 根据风格调整回复方式。
• 场景二：学习难度级别选择。在答题练习应用中，让学生选择题目难度（如”入门”、“进阶”、“挑战”）。可以为每个难度配置自定义显示模板，展示难度图标和简要说明，帮助学生快速理解并选择适合自己的难度。

加载中...

查看 JSON

复制 JSON

3. 功能配置

属性

基本折叠组

配置项	说明
绑定变量	组件的变量名，用户选择的值会存储到这个变量中。其他组件可以绑定此变量来获取选中的值，调用工作流时此变量也会传递给后端。
标题	显示在组件左侧的标签文字，用于说明这个选择项的用途，如”选择风格”、“难度级别”。
可多选	开启后允许用户同时选择多个选项。关闭时为单选模式，用户只能选择一个选项。开启多选后会出现额外的数据格式配置项。
仅提取值	仅在开启多选时显示。开启后，变量中只存储选中项的值（如 ["A", "B"]）；关闭后，变量中会存储完整的选项数据（包含标签、值等所有信息）。一般建议开启，使数据更简洁。

选项折叠组

配置项	说明
数据	配置可供选择的选项列表。每个选项包含”标签”（显示给用户看的文字）和”值”（实际存储的数据）。可以手动添加选项，也可以绑定变量从外部获取选项数据。
自定义显示模板	开启后可以自定义每个选项的显示样式。点击”配置显示模板”按钮后，可以分别设置”默认态模板”（选项未选中时的样式）和”激活态模板”（选项被选中时的样式）。通过自定义模板，可以在选项中添加图片、图标、描述文字等丰富内容，让选项展示更加生动直观。

状态折叠组

配置项	说明
可见	控制组件是否显示在页面上。默认可见。可以绑定变量实现动态控制。
隐藏	控制组件是否隐藏。与”可见”相反。
隐藏时删除字段	开启后，当组件被隐藏时，其存储的值会从数据中删除。适用于根据条件显示的选择项，避免提交无关数据。
静态展示	开启后，组件变为只读的纯文本展示模式，只显示已选中的选项，不可再进行选择操作。适用于详情页或确认页面。
禁用	控制组件是否禁用。禁用后组件变灰，用户无法进行选择操作。可以绑定变量实现动态控制，例如在某些条件满足前禁用选择。

事件

配置项	说明
添加事件	支持”值变化”事件，当用户选择或取消选择选项时触发。常见用途：选择后立即调用工作流处理，或根据选择结果控制其他组件的显示状态。例如，用户选择”高级模式”后，自动显示更多配置选项。