Vue3表单组件el-form校验规则rules属性

---

一、前言

在使用 Element UI (如今称为 Element Plus) 的表单组件 el-form 时，rules 属性用于定义表单项的校验规则。这些规则可以资助你确保用户输入的数据符合预期的格式和要求。
1.根本用法

rules 是一个对象，此中每个键对应一个表单项的字段名，值是一个或多个校验规则。常见的校验规则包罗必填、数据范例、最小长度、最大长度、自定义校验等。
2.示例代码

以下是一个包含多个校验规则的示例：

1. <template>
2.   <el-form :model="formData" :rules="rules" ref="form">
3.     <el-form-item label="用户名" prop="username">
4.       <el-input v-model="formData.username"></el-input>
5.     </el-form-item>
6.     <el-form-item label="邮箱" prop="email">
7.       <el-input v-model="formData.email"></el-input>
8.     </el-form-item>
9.     <el-form-item label="密码" prop="password">
10.       <el-input type="password" v-model="formData.password"></el-input>
11.     </el-form-item>
12.     <el-button type="primary" @click="submitForm">提交</el-button>
13.   </el-form>
14. </template>
16. <script>
17. export default {
18.   data() {
19.     return {
20.       formData: {
21.         username: '',
22.         email: '',
23.         password: ''
24.       },
25.       rules: {
26.         username: [
27.           { required: true, message: '用户名不能为空', trigger: 'blur' },
28.           { min: 3, max: 15, message: '用户名长度应在3到15个字符之间', trigger: 'blur' }
29.         ],
30.         email: [
31.           { required: true, message: '邮箱不能为空', trigger: 'blur' },
32.           { type: 'email', message: '请输入有效的邮箱地址', trigger: 'blur' }
33.         ],
34.         password: [
35.           { required: true, message: '密码不能为空', trigger: 'blur' },
36.           { min: 6, max: 20, message: '密码长度应在6到20个字符之间', trigger: 'blur' }
37.         ]
38.       }
39.     };
40.   },
41.   methods: {
42.     submitForm() {
43.       this.$refs.form.validate((valid) => {
44.         if (valid) {
45.           console.log('表单提交成功');
46.         } else {
47.           console.log('表单校验失败');
48.           return false;
49.         }
50.       });
51.     }
52.   }
53. };
54. </script>

复制代码

3.校验规则详解

• required: 体现该字段是否为必填项。
  
• message: 校验失败时显示的错误提示信息。
  
• trigger: 触发校验的机会，常见的值有 'blur' 和 'change'。
  
• type: 指定校验的数据范例，如 'string'、'number'、'email'、'url' 等。
  
• min 和 max: 指定字符串长度或数值的范围，只在 type 为 'string' 或 'number' 时有效。
  
• 自定义校验函数: 可以通过 validator 属性定义一个自定义的校验函数。
  

4.自定义校验函数示例

偶然候内置的校验规则无法满足需求，这时可以使用自定义校验函数：

1. rules: {
2.   password: [
3.     { required: true, message: '密码不能为空', trigger: 'blur' },
4.     { min: 6, max: 20, message: '密码长度应在6到20个字符之间', trigger: 'blur' },
5.     { validator: validatePasswordStrength, trigger: 'blur' }
6.   ]
7. }
9. function validatePasswordStrength(rule, value, callback) {
10.   if (!/\d/.test(value)) {
11.     callback(new Error('密码必须包含至少一个数字'));
12.   } else if (!/[a-zA-Z]/.test(value)) {
13.     callback(new Error('密码必须包含至少一个字母'));
14.   } else {
15.     callback();
16.   }
17. }

复制代码

在这个示例中，validatePasswordStrength 函数被用作自定义校验函数，确保密码至少包含一个数字和一个字母。
二、总结

通过公道设置 el-form 中的 rules 属性，可以实现复杂的表单校验逻辑，提拔表单的易用性和数据的可靠性。根据具体需求选择合适的校验规则和触发机会，是实现高质量表单的关键。

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。