前端开发 vue 中如何实现 u-form 多个form表单同时校验

在 Vue 项目中使用 UView UI 的 u-form 组件时，多个表单同时校验的需求非常常见。例如，当我们有多个表单需要在同一个页面中进行校验并提交时，我们需要确保每个表单都能进行单独验证，同时可以在同一时刻进行批量验证。

接下来，我们结合实际项目的代码，讲解如何使用 u-form 组件实现多个表单同时校验。

1. 项目背景

假设你有一个页面，需要用户同时填写用户信息和公司信息两个表单。用户信息包括姓名和年龄，公司的信息包括公司名和职位。你希望在用户点击提交按钮时，能够同时校验这两个表单，确保每个表单的数据都符合要求。

2. 代码示例

2.1 页面模板

<template><view><!-- 用户信息表单 --><u-form :model="userForm" ref="userForm" @submit="submitForms"><u-form-item label="姓名" prop="name" :rules="nameRules"><u-input v-model="userForm.name" placeholder="请输入姓名" /></u-form-item><u-form-item label="年龄" prop="age" :rules="ageRules"><u-input type="number" v-model="userForm.age" placeholder="请输入年龄" /></u-form-item><u-form-item><u-button type="primary" block formType="submit">提交用户信息</u-button></u-form-item></u-form><!-- 公司信息表单 --><u-form :model="companyForm" ref="companyForm" @submit="submitForms"><u-form-item label="公司名称" prop="companyName" :rules="companyNameRules"><u-input v-model="companyForm.companyName" placeholder="请输入公司名称" /></u-form-item><u-form-item label="职位" prop="position" :rules="positionRules"><u-input v-model="companyForm.position" placeholder="请输入职位" /></u-form-item><u-form-item><u-button type="primary" block formType="submit">提交公司信息</u-button></u-form-item></u-form><!-- 提交按钮 --><u-button type="success" block @click="submitForms">提交所有信息</u-button></view>
</template>

2.2 页面脚本

<script>
export default {data() {return {// 用户信息表单的数据userForm: {name: '',age: ''},// 用户信息表单的校验规则nameRules: [{ required: true, message: '姓名是必填的', trigger: 'blur' }],ageRules: [{ required: true, message: '年龄是必填的', trigger: 'blur' },{ type: 'number', message: '请输入有效的年龄', trigger: 'blur' }],// 公司信息表单的数据companyForm: {companyName: '',position: ''},// 公司信息表单的校验规则companyNameRules: [{ required: true, message: '公司名称是必填的', trigger: 'blur' }],positionRules: [{ required: true, message: '职位是必填的', trigger: 'blur' }]};},methods: {// 提交表单submitForms() {// 同时校验所有表单const userFormValidation = this.$refs.userForm.validate();const companyFormValidation = this.$refs.companyForm.validate();// 使用 Promise.all 来并行验证多个表单Promise.all([userFormValidation, companyFormValidation]).then(() => {// 如果所有表单验证通过this.$u.toast('所有表单验证通过，提交成功');// 可以在这里进行数据提交}).catch(() => {// 如果有任何表单验证失败this.$u.toast('表单验证失败，请检查输入');});}}
};
</script>

3. 详细说明

3.1 表单组件使用

1. u-form：这是 UView UI 中的表单组件。每个表单组件通过 :model 绑定对应的数据对象，通过 ref 设置引用名，以便在 JavaScript 中获取并调用表单的验证方法。

2. u-form-item：每个表单项。它用来包装一个表单字段，并且通过 prop 来指定字段名称，用来与表单数据进行绑定。

3. u-input：用于输入数据的组件。它通过 v-model 来双向绑定数据。

3.2 校验逻辑

1. 表单校验规则：每个表单项都有相应的校验规则（rules）。这些规则确保字段的输入符合预期。在此示例中，我们使用了必填和类型检查（如 number 类型）的规则。

2. validate 方法：每个 u-form 组件都有一个 validate 方法，它会触发表单的校验并返回一个 Promise。如果表单验证成功，Promise 会成功解析；如果验证失败，Promise 会被拒绝。

3.3 提交和批量校验

1. submitForms 方法：这是页面的提交处理方法。在该方法中，我们使用了 this.$refs.userForm.validate() 和 this.$refs.companyForm.validate() 来分别触发两个表单的校验，并通过 Promise.all 来并行校验这两个表单。

2. Promise.all：我们将两个表单的校验 Promise 包装到 Promise.all 中。这样，两个表单的校验会同时进行。当所有表单验证都成功时，then 方法被触发；如果有任何一个表单验证失败，catch 方法会被触发。

3. this.$u.toast：用来显示提示消息，通知用户是否提交成功或失败。

4. 关键点总结

• 使用 ref 引用多个表单，方便访问每个表单实例。
• 通过 this.$refs.form.validate() 触发表单校验。
• 使用 Promise.all 来并行校验多个表单，确保所有表单的验证同时进行。
• 利用 validate 返回的 Promise 来处理校验成功与失败的逻辑。

5. 实际项目中的应用场景

在实际项目中，可能会有以下场景需要处理多个表单的验证：

• 多步骤表单：用户在不同的步骤中填写不同的表单，在提交时需要同时验证所有步骤的表单。
• 用户与公司信息：用户需要在同一页面提交多个表单（例如，个人信息和公司信息），而且这些表单有不同的校验规则。
• 动态表单：根据不同的用户选择，动态展示多个表单项，最后进行一次统一的验证。

通过使用 u-form 的并行校验方法，可以方便地实现这些需求，提高用户体验和开发效率。