低代码平台表单设计器 unione-form-editor 组件 ------ 子数据组件
在企业业务表单中,一对多关系无处不在:一张订单 → 对应多个商品一张入库单 → 对应多条物料一个客户 → 对应多个联系人一个合同 → 对应多条回款计划
要在表单里实现 "主子表" 结构 ,就必须使用核心组件 ------子数据组件。
子数据组件是关联组件的延伸 ,专门负责一对多关联数据在表单中的呈现与维护,是实现主子表单、明细列表、批量数据录入的关键组件。

一、子数据组件核心定位:一对多关联的明细容器
子数据组件的核心作用只有一句话:作为主表单的 "子表容器",展示、维护与当前表单呈 1 对多 关系的关联数据。
它是主表与子表之间的桥梁,让:
- 一张表单里可以直接编辑多条明细
- 主子数据自动关联外键
- 新增 / 编辑 / 删除 / 批量操作一站式完成
- 数据保存时主子表同步提交,事务一致
简单理解:主表单 = 单条数据 子数据组件 = 多条明细数据
二、子数据组件核心特性
1. 标准一对多关联(企业级外键关系)
与主表单建立 1:N 外键关联,一个主记录对应多条子记录,数据结构标准、稳定、可关联查询。
2. 内嵌子表单,支持增删改查
在主表单内部直接显示为明细表格,支持:
- 添加行
- 编辑行
- 删除行
- 上移下移
- 批量操作无需跳转页面,一站式维护。
3. 自动继承主表外键
保存主表单时,子表数据自动绑定主表 ID,无需手动设置关联关系,不会出现孤儿数据。
4. 支持拖拽列配置、显示隐藏字段
可自定义子表格显示哪些字段、顺序、宽度、对齐,完全可视化配置。
5. 支持字段联动、自动计算
子表内部字段可相互联动:
- 选择商品 → 自动带出规格、单价
- 填数量 → 自动计算金额
- 自动合计总金额、总数量
6. 支持校验、必填、唯一、重复判断
子表字段同样支持:
- 必填校验
- 数值范围
- 重复判断
- 唯一限制保证明细数据规范合法。
7. 支持导出、批量操作
子数据可直接:
- 导出 Excel
- 批量删除
- 批量赋值
三、子数据组件标准配置流程
第一步:数据模型建立一对多关联
在主表数据模型中配置 一对多关联,指定关联子表、外键字段。
第二步:表单中添加子数据组件
拖拽子数据组件到主表单画布。
第三步:绑定一对多关联数据
选择已配置好的 一对多关联,设置:
- 表格显示列
- 是否允许添加 / 编辑 / 删除
- 是否显示序号、合计行
- 子表字段校验规则
完成配置 → 主子表单结构立即生效!
四、子数据组件高频企业场景
- 销售订单 → 订单商品明细
- 采购订单 → 采购物料明细
- 入库单 → 入库明细
- 出库单 → 出库明细
- 合同 → 合同回款计划
- 报价单 → 报价商品明细
- 退货单 → 退货商品明细
- 巡检单 → 巡检项目明细
只要是 "一主多子" 业务,必须用子数据组件。
五、结语
子数据组件是企业表单从 "简单表单" 升级为 **"业务系统"** 的标志性组件。它实现了最核心的 一对多数据结构,让表单真正具备订单、入库、出库、合同等企业级业务能力。
没有子数据组件,就没有真正的企业业务表单。
项目已开源,欢迎 Star 收藏~