组合式函数组织表单校验的核心是解耦验证规则、校验触发与错误状态管理;通过抽离规则模块、封装useformvalidation函数、利用computed+watcheffect处理联动校验,并分离错误提示与提交状态。

在组合式函数中组织复杂表单校验逻辑,核心是把「验证规则」、「校验触发」和「错误状态管理」三者解耦,再按功能聚合封装,避免规则散落、逻辑混杂或重复造轮子。
抽离可复用的校验规则模块
不要把规则写死在组件里。把通用规则(如邮箱、手机号、密码强度)和业务规则(如“企业名称必填当类型为enterprise”)分别导出为独立常量或函数:
- 基础规则用数组导出:export const emailRule = [{ type: 'email', message: '邮箱格式不正确' }]
- 动态规则写成工厂函数:export const accountTypeDependentRule = (form) => form.type === 'enterprise' ? [{ required: true, message: '请填写企业名称' }] : []
- 自定义异步校验单独封装:export const uniqueUsernameValidator = (value) => api.checkUsername(value).then(res => res.available ? true : '用户名已被占用')
封装 useFormValidation 组合函数
创建一个专注表单验证的组合函数,接收初始表单数据,返回带校验能力的状态与方法:
- 内部用 reactive 管理 errors 对象,每个字段对应一个字符串错误消息
- 提供 validateField(key) 手动触发单字段校验,适合 blur 或 input 实时反馈
- 提供 validateAll() 遍历所有字段规则并汇总结果,用于提交前总检
- 支持传入规则映射对象:useFormValidation(form, { username: usernameRule, email: emailRule })
联动校验用 computed + watchEffect 协同处理
当某字段变化影响其他字段校验逻辑时(比如选择用户类型后开启/关闭某字段必填),不用手动监听再调用 validateField:
- 把依赖字段的规则包装进 computed,例如:const dynamicPhoneRule = computed(() => form.country === 'CN' ? phoneRuleForCN : phoneRuleForUS)
- 在组合函数内部用 watchEffect 自动追踪该 computed,并触发对应字段重校验
- 这样既保持响应性,又避免在模板中堆砌 v-if/v-else 控制规则显隐
错误提示与提交状态分离管理
校验结果不该只用于显示红字提示——它还应驱动按钮禁用、提交锁、甚至埋点上报:
- 用 computed 派生 isFormValid:自动汇总所有字段是否通过
- 用 ref 管理 isSubmitting,结合 try/catch 在 submitHandler 中控制流程
- 错误信息结构统一为 { [field: string]: string | null },方便透传给子组件或 FormItem
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










