低代码平台表单设计器 unione-form-editor 组件 —— 子数据组件

低代码平台表单设计器 unione-form-editor 组件 —— 子数据组件

在企业业务表单中，一对多关系无处不在：一张订单 → 对应多个商品一张入库单 → 对应多条物料一个客户 → 对应多个联系人一个合同 → 对应多条回款计划

要在表单里实现 “主子表” 结构 ，就必须使用核心组件 ——子数据组件。

子数据组件是关联组件的延伸，专门负责一对多关联数据在表单中的呈现与维护，是实现主子表单、明细列表、批量数据录入的关键组件。

一、子数据组件核心定位：一对多关联的明细容器

子数据组件的核心作用只有一句话：作为主表单的 “子表容器”，展示、维护与当前表单呈 1 对多 关系的关联数据。

它是主表与子表之间的桥梁，让：

• 一张表单里可以直接编辑多条明细
• 主子数据自动关联外键
• 新增 / 编辑 / 删除 / 批量操作一站式完成
• 数据保存时主子表同步提交，事务一致

简单理解：主表单 = 单条数据子数据组件 = 多条明细数据

二、子数据组件核心特性

1. 标准一对多关联（企业级外键关系）

与主表单建立1:N 外键关联，一个主记录对应多条子记录，数据结构标准、稳定、可关联查询。

2. 内嵌子表单，支持增删改查

在主表单内部直接显示为明细表格，支持：

• 添加行
• 编辑行
• 删除行
• 上移下移
• 批量操作无需跳转页面，一站式维护。

3. 自动继承主表外键

保存主表单时，子表数据自动绑定主表 ID，无需手动设置关联关系，不会出现孤儿数据。

4. 支持拖拽列配置、显示隐藏字段

可自定义子表格显示哪些字段、顺序、宽度、对齐，完全可视化配置。

5. 支持字段联动、自动计算

子表内部字段可相互联动：

• 选择商品 → 自动带出规格、单价
• 填数量 → 自动计算金额
• 自动合计总金额、总数量

6. 支持校验、必填、唯一、重复判断

子表字段同样支持：

• 必填校验
• 数值范围
• 重复判断
• 唯一限制保证明细数据规范合法。

7. 支持导出、批量操作

子数据可直接：

• 导出 Excel
• 批量删除
• 批量赋值

三、子数据组件标准配置流程

第一步：数据模型建立一对多关联

在主表数据模型中配置一对多关联，指定关联子表、外键字段。

第二步：表单中添加子数据组件

拖拽子数据组件到主表单画布。

第三步：绑定一对多关联数据

选择已配置好的一对多关联，设置：

• 表格显示列
• 是否允许添加 / 编辑 / 删除
• 是否显示序号、合计行
• 子表字段校验规则

完成配置 → 主子表单结构立即生效！

四、子数据组件高频企业场景

• 销售订单 → 订单商品明细
• 采购订单 → 采购物料明细
• 入库单 → 入库明细
• 出库单 → 出库明细
• 合同 → 合同回款计划
• 报价单 → 报价商品明细
• 退货单 → 退货商品明细
• 巡检单 → 巡检项目明细

只要是 “一主多子” 业务，必须用子数据组件。

五、结语

子数据组件是企业表单从 “简单表单” 升级为 **“业务系统”** 的标志性组件。它实现了最核心的一对多数据结构，让表单真正具备订单、入库、出库、合同等企业级业务能力。

没有子数据组件，就没有真正的企业业务表单。

项目已开源，欢迎 Star 收藏～

GitHub：https://github.com/unione-cloud/unione-form-editor

Gitee：https://gitee.com/unione-cloud/unione-form-editor