Valibot 表单验证：如何实现数组元素唯一性校验

在基于 Vue.js 和 PrimeVue 的前端开发中，表单验证是一个常见需求。Valibot 作为一个轻量级的 TypeScript 模式验证库，提供了强大的数据验证能力。本文将重点探讨如何使用 Valibot 实现数组元素的唯一性校验，特别是在表单场景下的应用。

问题背景

在实际开发中，我们经常需要验证数组中的元素是否具有唯一属性。例如，在一个菜品管理系统中，可能需要确保菜品配料列表中的每个配料名称都是唯一的。

Valibot 验证方案

Valibot 提供了灵活的验证组合方式，我们可以通过自定义验证函数来实现数组元素的唯一性校验。以下是核心实现思路：

1. 基础对象验证：首先定义每个数组元素的基本验证规则
2. 数组验证：然后对整个数组应用验证
3. 自定义校验：最后添加针对数组元素的唯一性校验

实现代码示例

// 定义检查数组元素属性是否唯一的函数
function hasUniqueProperty(arr: any[], property: string): boolean {
  const seen = new Set();
  for (const item of arr) {
    const value = item[property];
    if (seen.has(value)) {
      return false;
    }
    seen.add(value);
  }
  return true;
}

// 定义菜品验证模式
export const DishSchema = v.object({
  name: v.pipe(v.string(), v.minLength(4)),
  description: v.pipe(v.string(), v.maxLength(5000)),
  ingredients: v.pipe(
    v.array(
      v.object({
        name: v.pipe(v.string(), v.minLength(4)),
      }),
    ),
    v.checkItems(
      (items) => hasUniqueProperty(items, 'name'),
      '配料名称不能重复'
    ),
  ),
});

与 PrimeVue 表单集成

将 Valibot 验证器与 PrimeVue 表单组件集成时，需要注意以下几点：

1. 表单验证器设置：使用 valibotResolver 将 Valibot 模式转换为表单验证器
2. 错误信息展示：通过表单的 $form 插槽属性访问验证错误
3. 数组字段命名：确保表单字段名称与模式定义一致

<Form :resolver="dishValidator">
  <!-- 其他字段... -->
  <div v-for="(item, index) in formData.ingredients" :key="index">
    <InputText v-model="formData.ingredients[index].name" />
  </div>
  <Message v-if="$form.ingredients?.invalid" severity="error">
    {{ $form.ingredients.error.message }}
  </Message>
</Form>

性能优化建议

1. 避免重复计算：使用 Set 数据结构代替数组来检查唯一性，提高性能
2. 延迟验证：设置 validateOnBlur 或 validateOnChange 来优化用户体验
3. 条件验证：只在数组长度大于1时才执行唯一性检查

常见问题解决

1. 验证不触发：确保表单字段名称与模式定义完全匹配
2. 错误信息不显示：检查是否正确绑定了验证结果到消息组件
3. 性能问题：对于大型数组，考虑使用防抖或节流技术优化验证频率

总结

通过 Valibot 的灵活验证组合，我们可以轻松实现复杂的表单验证逻辑，包括数组元素的唯一性校验。与 PrimeVue 表单组件结合使用时，需要注意正确的字段命名和错误信息绑定。这种方案不仅保持了代码的简洁性，还提供了强大的类型安全保证，是现代前端表单验证的理想选择。