Vue 3动态表单核心是统一数据模型、校验与提交路径:用reactive嵌套结构对齐业务Schema,递归getFormData按path采集,封装结构驱动校验器支持异步与跨字段规则,确保三者语义一致。

Vue 3 动态表单收集并提交复杂结构化数据,关键不在“怎么渲染”,而在于“怎么组织数据模型 + 怎么让校验与提交逻辑跟得上结构变化”。尤其当表单含嵌套对象、动态数组、多级联动字段时,硬靠 v-model 一层层手动绑定会迅速失控。下面从三个实操性强的维度讲清楚怎么做。
用 reactive + 深层路径映射管理嵌套结构
复杂结构(如车主信息+车辆信息+访客时段列表)不能扁平展开成一维对象,否则字段命名混乱、增删数组项时 key 易错、联动更新困难。推荐用嵌套 reactive 对象直接对齐业务 Schema:
- 定义初始结构时,就按后端接口要求建模,比如:
form.baseInfo.plateNumber、form.visitSchedule[0].startTime - 动态数组字段(如随车物品清单)用
ref([])或reactive([]),新增项时 push 一个带唯一id的对象,避免用索引做 key - 所有字段名和嵌套路径,必须与 JSON Schema 中的
path或field字段严格一致,后续采集、校验、提交才能自动对齐
统一采集入口:递归遍历 schema + 路径取值
不要在每个子组件里分别 emit 数据,而是由顶层表单组件提供一个 getFormData() 方法,根据当前 schema 配置递归提取值:
从零开始编排 SpringBoot+Vue 全栈项目工作流,适用于新建全栈项目或完整脚手架请求,触发后依次调用 product‑spec‑builder(需求调研)等模块。
- schema 中每个字段配置应包含
path(如"ownerInfo.idCard"或"visitSchedule.0.startTime"),支持点号和数组下标语法 -
getFormData()内部用函数安全解析路径,例如:getByPath(form, item.path),处理undefined和数组越界 - 对
visitSchedule这类动态数组,schema 中可标记type: "array",采集时自动过滤空项、剔除未填的临时项
提交前校验:结构驱动 + 异步协同
复杂表单的校验不能只靠 Element Plus 的 validate(),它只认 prop 字符串,不认嵌套路径。需自己封装校验调度器:
立即学习“前端免费学习笔记(深入)”;
- 每个字段 schema 带
rules数组,含required、pattern、validator(支持返回 Promise) - 校验函数按 schema 顺序执行,遇到异步规则(如车牌号查重)自动 await,失败则中断并高亮对应字段
- 跨字段规则(如“保险到期时间必须晚于年检到期时间”)单独抽成
crossRules,在全部字段校验通过后再触发 - 最终提交的数据,就是经过校验后的
getFormData()返回值,无需二次转换,直传后端
不复杂但容易忽略:动态表单真正难的不是渲染,而是让数据结构、校验路径、提交载荷三者始终保持语义一致。只要 schema 定义清晰、路径解析健壮、采集逻辑集中,再深的嵌套、再多的动态块,也能稳稳收上来。

















