组合输入
1. 组件概述
Section titled “1. 组件概述”组合输入是一个数据输入组件，用于收集一组相关联的数据。它可以将多个表单项组合在一起作为一个整体，支持动态增加或删除数据条目，也支持拖拽排序。组合输入适用于需要收集多条同类型数据的场景，例如添加多个联系人信息、配置多组参数、填写多条学习记录等。
加载中...
查看 JSON
复制 JSON
2. 应用场景示例
Section titled “2. 应用场景示例”-
场景一：收集多个学习目标。在学习计划类应用中，用户需要填写多个学习目标，每个目标包含”目标名称”和”优先级”两个字段。使用组合输入，开启”可多选”和”可新增”，用户可以自由添加多条学习目标，填写完成后点击按钮触发工作流，AI 可以根据这些目标生成个性化的学习计划。
-
场景二：配置 AI 对话的多轮提示词。在 AI Agent 配置页面，用户需要设置多条系统提示词，每条包含”角色”和”内容”。使用组合输入收集这些提示词配置，开启”可排序”让用户调整提示词顺序，工作流获取后按顺序发送给 AI 模型。
加载中...
查看 JSON
复制 JSON
3. 功能配置
Section titled “3. 功能配置”| 配置项 | 说明 |
|---|---|
| 绑定变量 | 组件的变量名，用户输入的数据会以此变量名存储。其他组件可以绑定此变量来显示其值，调用工作流时此变量的值会传递给工作流。 |
| 标题 | 表单项左侧显示的标签文字，用于说明该输入项的用途，如”联系人列表”、“学习目标”。 |
| 可多选 | 开启后允许添加多条数据，形成一个数据列表。关闭则只能填写单条数据。开启多选后会自动显示”最多条数”、“最少条数”等相关配置。 |
| 最多条数 | 限制用户最多可以添加多少条数据。仅在开启”可多选”时显示。 |
| 最少条数 | 限制用户至少需要填写多少条数据。仅在开启”可多选”时显示。 |
| 打平值 | 当组合输入内只有一个表单项且开启多选时可用。开启后，数据结构会从对象数组简化为值数组。例如原本是 [\{name: "张三"\}, \{name: "李四"\}]，打平后变为 ["张三", "李四"]。 |
| 拼接值 | 在”打平值”开启后可用。开启后会将数组中的值用连接符拼接成一个字符串。 |
| 拼接符 | 在”拼接值”开启后可用。设置将多个值拼接成字符串时使用的连接符号，默认为逗号。 |
| 可排序 | 开启后用户可以通过拖拽来调整各条数据的顺序。仅在开启”可多选”时显示。 |
| 提示文字 | 拖拽排序的提示文字，在开启”可排序”后显示在组件下方。 |
| 可新增 | 开启后显示”新增”按钮，用户可以点击添加新的数据条目。仅在开启”可多选”时显示。 |
| 可删除 | 开启后每条数据旁边显示删除按钮，用户可以删除不需要的条目。仅在开启”可多选”时显示。 |
| 按钮模式 | 删除按钮的显示方式，可选”图标”或”按钮”。选择”按钮”时可以自定义按钮文案和样式。 |
| 文案 | 删除按钮的文字，仅在按钮模式为”按钮”时显示。 |
| 样式 | 删除按钮的视觉风格，仅在按钮模式为”按钮”时显示。 |
| 删除 | 配置删除数据时调用的接口。如果配置了此接口，删除前会先调用接口确认。 |
| 确认文案 | 删除确认对话框中显示的提示文字，仅在配置了删除接口时生效。 |
| 配置唯一项 | 从组合输入内的表单项中选择一个作为唯一项。设置后，该字段的值在所有条目中不能重复。适用于需要保证某个字段值唯一的场景，如”用户名”不能重复。 |
| 标题提示 | 在标题旁边显示一个小问号图标，鼠标悬停时弹出提示内容。 |
| 控件提示 | 在输入控件旁边显示一个小问号图标，鼠标悬停时弹出提示内容。 |
| 占位提示 | 当没有任何数据时显示的提示文字。 |
| 描述 | 显示在组件下方的说明文字，用于补充解释该配置项的用途或填写要求。 |
| 配置项 | 说明 |
|---|---|
| 自动填充父级变量 | 开启后，组合输入内的表单项可以访问父级的变量数据。默认关闭，组合输入内部是独立的数据环境。 |
| 严格模式 | 默认开启。如果希望外部变量的值能实时同步到组合输入内部，可以关闭此选项。 |
| 同步字段 | 在关闭严格模式后可用。当组合输入层级较深时，可以指定需要从外层同步的字段名，确保内部能获取到最新的外部数据。 |
| 懒加载 | 当数据条目较多导致页面卡顿时，可以开启此选项提升性能。仅在开启”可多选”且未使用选项卡展示时可用。 |
| 配置项 | 说明 |
|---|---|
| 可见 | 控制组件是否显示。 |
| 隐藏 | 控制组件是否隐藏，与”可见”相反。 |
| 禁用 | 控制组件是否禁用。禁用后组件变灰且不可操作。 |
| 只读 | 开启后组件变为只读状态，用户无法编辑。 |
| 配置项 | 说明 |
|---|---|
| 校验规则 | 配置组合输入的校验规则，如必填等。校验失败时会显示错误提示。 |
| 配置项 | 说明 |
|---|---|
| 展示形式 | 多条数据的展示方式，可选”表单”或”选项卡”。选择”表单”时所有条目纵向排列显示；选择”选项卡”时每条数据显示为一个标签页，点击切换查看。仅在开启”可多选”时显示。 |
| 样式 | 选项卡的视觉风格，可选”默认”、“线型”、“卡片”、“选择器”。仅在展示形式为”选项卡”时显示。 |
| 标题模版 | 选项卡标题的显示内容，可以绑定变量动态显示。仅在展示形式为”选项卡”时显示。 |
| 多行展示 | 开启后每个表单项独占一行，关闭则多个表单项在同一行内横向排列。仅在展示形式为”表单”时显示。 |
| 去掉边框 | 开启后移除组合输入的边框。仅在开启”多行展示”时显示。 |
表单项折叠组
Section titled “表单项折叠组”| 配置项 | 说明 |
|---|---|
| 子表单 | 组合输入内部表单项的布局模式。仅在开启”多行展示”时显示。 |
| 配置项 | 说明 |
|---|---|
| 添加事件 | 组合输入支持四种触发事件：添加（用户点击新增按钮添加条目时触发）、删除（用户删除某条数据时触发）、拖拽结束（用户拖拽排序完成时触发）、切换tab（展示形式为选项卡时，用户切换标签页时触发）。可以在这些事件中配置动作，如调用工作流处理数据变化。 |