Vue3中使用vee-validate的useForm/useField校验数组时如何展示全部错误
数组表单全量校验错误展示的调整方案
核心问题根源
- 依赖配置层面:yup 默认开启
abortEarly: true,校验流程遇到第一个错误就直接终止,无法收集全量错误 - 字段绑定层面:数组内字段如果没有绑定带索引的唯一路径,多个同名字段的错误会互相覆盖
- 错误读取层面:如果直接使用
useField返回的局部errorMessage作为错误展示来源,该值仅会返回当前字段的单条触发错误,无法保留其他字段的校验结果
你当前使用的vee-validate@4.2.3、vue@3.0.0、yup@0.32.9版本完全支持全量错误收集,无需升级依赖。
具体调整步骤
1. 配置全局表单参数,开启全量错误收集
在useForm初始化时,透传yup的校验配置,关闭提前终止逻辑,让yup可以遍历所有校验规则,收集全部不通过的错误:
import { useForm } from 'vee-validate'; import * as yup from 'yup'; // 定义数组类型的校验schema const formSchema = yup.object({ userList: yup.array().of( yup.object({ username: yup.string().required('用户名不能为空'), age: yup.number().min(18, '年龄需满18岁').required('年龄为必填项') }) ) }); const { // 读取全局错误集合,替代局部字段返回的单条errorMessage errors, // 全局校验方法,统一触发全表校验 validate } = useForm({ validationSchema: formSchema, // 透传yup校验配置,关闭提前终止,收集全量错误 validateSchemaOptions: { abortEarly: false }, initialValues: { userList: [ { username: '', age: '' }, { username: 'demo', age: '17' } ] } });
2. 绑定带唯一索引的字段路径
遍历渲染数组表单项时,给每个输入框绑定带数组索引的完整路径,避免同名字段的错误互相覆盖:
<template v-for="(item, index) in formValues.userList" :key="index"> <div class="form-item"> <Field :name="`userList[${index}].username`" type="text" placeholder="请输入用户名" /> <!-- 从全局errors集合中按对应路径读取该字段的错误 --> <p v-if="errors[`userList[${index}].username`]" class="error-tip"> {{ errors[`userList[${index}].username`] }} </p> </div> <div class="form-item"> <Field :name="`userList[${index}].age`" type="number" placeholder="请输入年龄" /> <p v-if="errors[`userList[${index}].age`]" class="error-tip"> {{ errors[`userList[${index}].age`] }} </p> </div> </template>
3. 统一校验触发逻辑
- 表单提交时,直接调用
useForm返回的全局validate方法,该方法会完整执行所有校验规则,将全部不通过的错误写入全局errors对象,实现一次性展示所有问题 - 日常输入触发校验时,由于每个字段都有独立的路径标识,每次校验仅会更新当前操作字段对应的错误条目,不会清空其他字段已存在的错误
注意:不要单独调用数组项内
useField返回的局部校验方法,否则会触发单字段独立校验逻辑,覆盖全局错误集合中的原有内容。
效果说明
调整完成后,不管是手动触发全表校验,还是用户逐步输入,所有校验不通过的错误都会持续展示在界面对应位置,不会出现修改某一项时其他错误消失、单条错误来回切换的问题。
内容的提问来源于stack exchange,提问作者Logshoy
相关产品推荐
相关产品推荐

