子表单项

1. 组件概述

子表单项是一个数据输入组件，用于在弹窗中编辑复杂的子数据结构。当表单中某个字段本身包含多个子字段时（比如一个”联系人”字段包含姓名、电话、邮箱等），可以使用子表单项将这些子字段收纳在一个弹窗中进行编辑，避免主表单过于复杂。用户点击按钮后会弹出一个包含子表单的弹窗，填写完成后数据会保存到该字段中。

加载中...

查看 JSON

复制 JSON

2. 应用场景示例

• 场景一：AI 角色配置。在搭建 AI 对话应用时，需要配置 AI 角色的详细信息（角色名称、性格描述、知识背景、回复风格等）。使用子表单项可以将这些配置收纳在一个弹窗中，用户点击”配置角色”按钮即可打开弹窗进行详细设置，主界面保持简洁。
• 场景二：学习任务管理。在学习辅导类应用中，学生需要添加多个学习任务，每个任务包含任务名称、学科、难度、预计时长等信息。开启多选模式后，学生可以添加多个任务条目，点击每个条目可以编辑其详细信息。

加载中...

查看 JSON

复制 JSON

3. 功能配置

基础

配置折叠组

配置项	说明
配置成员渲染器	点击此按钮可以打开子表单的配置界面，在弹窗中设计子表单包含哪些字段。例如添加文本框、下拉框等组件来收集子数据的各个属性。
名称字段名	指定子数据中用于显示名称的字段。当子数据中存在该字段时，按钮上会显示该字段的值，方便用户识别当前编辑的是哪条数据。默认值为”label”。例如子数据有 {label: "张三", phone: "123"} 时，按钮会显示”张三”。
按钮标签名	按钮上显示的默认文字。当子数据中没有名称字段或未设置名称字段名时，按钮会显示此文字。默认值为”设置”。
允许最少个数	仅在多选模式下生效。限制用户至少需要添加多少条子数据。设置后，当数据条数达到最少个数时，删除按钮会被禁用。
允许最多个数	仅在多选模式下生效。限制用户最多可以添加多少条子数据。设置后，当数据条数达到最多个数时，新增按钮会被禁用。