Vue 的 provide/inject 实现 Form 与 FormItem 跨层级响应式通信:Form 提供注册/注销、验证方法和禁用状态,FormItem 注入并双向绑定验证状态,支持异步校验与手动触发,需避免非响应式传参、嵌套注入错误及缓存 inject 结果。

通过 Vue 的 provide/inject,可以在 Form 与 FormItem(即表单容器与字段项)之间建立跨层级的响应式通信,从而将验证逻辑集中管理、统一触发,避免每个 Item 重复实现校验规则和状态同步。
Form 提供统一的验证上下文
在 Form 组件中使用 provide 暴露一个响应式对象,包含:
-
注册/注销字段:维护当前所有 FormItem 实例的引用(如用
ref([])或reactive({ items: [] })) -
验证方法:如
validate()遍历所有已注册 Item,调用其内部校验,并汇总结果 - 禁用状态:供子组件读取是否整体禁用(影响 Item 是否可交互、是否跳过校验)
注意:该 provide 对象需用 readonly 包裹写入方法,防止子组件意外修改内部结构;同时用 shallowRef 或 computed 确保响应式更新能被 inject 方正确追踪。
FormItem 主动注入并双向绑定验证状态
每个 FormItem 在 setup 中 inject Form 提供的上下文,并在 onMounted 时调用 register 方法将自身实例加入列表。关键点包括:
-
错误信息托管:FormItem 不自行维护
errorMessage,而是由 Form 统一收集各字段校验结果后,通过 inject 的响应式对象暴露给 Item 显示 -
校验触发联动:当用户输入、失焦或 Form 调用
validate()时,FormItem 执行本地规则(如 required、email),并将结果以{ valid: boolean, message: string }格式返回给 Form -
自动清理:在
onUnmounted中调用unregister,避免内存泄漏或旧实例干扰下次验证
支持异步规则与手动触发验证
对于需要发请求的异步校验(如用户名是否已存在),FormItem 可返回 Promise。Form 的 validate() 应支持 Promise.allSettled 收集所有字段结果,确保部分失败不影响整体流程控制。
同时提供 validateField(name) 方法,允许外部按字段名单独触发校验,适用于实时搜索建议、密码强度提示等场景。
避免常见陷阱
不要在 provide 中直接传入非响应式对象或普通函数 —— 否则子组件无法感知状态变化;不要让多个 Form 嵌套时 inject 错误层级 —— 可通过 Symbol 常量 + deep: false 注入选项限定作用域;不要在 FormItem 中缓存 inject 结果而不监听变更 —— 应始终从 inject 返回的对象中读取最新值(如 context.disabled.value)。









