列表选取

1. 组件概述

列表选取是一个数据输入组件，用于从大量数据中选择一条或多条记录。与普通下拉框不同，它通过弹窗或抽屉的方式展示完整的数据列表，支持分页、搜索、筛选等功能，让用户能够更方便地浏览和选择数据。适用于需要从较多选项中进行选择的场景，比如选择关联的知识库条目、选择历史对话记录等。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：知识库条目选择。在搭建 AI 问答应用时，需要让用户从知识库中选择参考资料。使用列表选取组件，配置数据源为知识库列表，开启多选功能，用户可以在弹窗中浏览、搜索并勾选多个知识条目，选中的条目会显示在输入框中。
• 场景二：历史对话引用。在对话类应用中，用户可能需要引用之前的对话内容。使用列表选取组件展示历史对话列表，用户点击后弹出对话记录列表，选择需要引用的对话，系统可以将选中的对话内容传递给工作流进行处理。

加载中...

查看 JSON

复制 JSON

3. 功能配置

基础

配置折叠组

配置项	说明
绑定变量	组件的变量名，用户选择的数据会以此变量名存储。其他组件可以绑定此变量来获取选中的数据，调用工作流时此变量的值也会传递给工作流。
标题	表单项左侧显示的标签文字，用于说明该选择项的用途，如”选择知识条目”、“引用对话”。
选框类型	控制选择列表的展示方式。可选值：内嵌（直接在页面上平铺展示列表）、弹框（点击后弹出模态框展示列表）、抽屉（点击后从侧边滑出抽屉展示列表）。默认为弹框模式。
弹框尺寸	当选框类型为弹框或抽屉时，控制弹出窗口的大小。可选值：默认、小、中、大、特大。数据量较多时建议选择较大的尺寸。
多选	开启后允许用户选择多条数据。关闭时只能选择一条。根据实际需求选择，如选择多个标签时开启，选择单个分类时关闭。
标签收纳	仅在开启多选后显示。当选中的数据较多时，可以设置最大显示数量，超出部分会收纳起来，鼠标悬停时显示完整列表。可配置最大标签数、收纳器的触发方式、提示位置等。
选中项可删除	控制已选中的数据是否可以单独删除。开启后，每个选中项旁边会显示删除按钮，用户可以点击移除单个选项。默认开启。
标题提示	在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。适合放置简短的帮助说明。
控件提示	在输入控件旁边显示一个小问号图标，鼠标悬停时弹出提示内容。
占位提示	未选择任何数据时显示的灰色提示文字，引导用户操作。如”请选择…”。
描述	显示在组件下方的浅色说明文字，用于补充解释该配置项的用途或填写要求。

选项折叠组

配置项	说明
数据	配置可供选择的数据来源。可以手动添加静态选项，也可以绑定变量从外部获取动态数据。
标签模板	自定义已选中数据在输入框中的显示内容。可以绑定变量来显示数据的特定字段。仅在非内嵌模式下可用。
配置选框详情	点击此按钮可以进入详细配置界面，自定义弹窗中数据列表的展示方式。可以配置列表的显示字段、搜索条件、分页设置等，让选择界面更符合实际需求。

状态折叠组

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

校验折叠组

配置项	说明
必填	开启后，该字段必须选择至少一项才能提交表单。

事件

配置项	说明
添加事件	支持”值变化”、“点击选项”、“静态展示节点点击”三种触发事件。“值变化”在用户选择或取消选择数据时触发，常用于联动更新其他组件或触发工作流处理选中的数据。“点击选项”在用户点击某个选项时触发。“静态展示节点点击”在静态展示模式下点击选项时触发。