vueelementuiel-form表单验证rules详细说明
参考⽂章：
Form 组件提供了表单验证的功能，只需要通过 rules 属性传⼊约定的验证规则，并将 Form-Item的 prop 属性设置为需校验的字段名即可。校验规则参见
⽂档中提及的⽤法有2种：
1.对整个表单进⾏规则验证：
<el-form :model="ruleForm" status-icon :rules="rules" ref="ruleForm" label-width="100px" class="demo-ruleForm">
<el-form-item label="密码" prop="pass">
<el-input type="password" v-model="ruleForm.pass" autocomplete="off"></el-input>
</el-form-item>
<el-form-item label="确认密码" prop="checkPass">
<el-input type="password" v-model="ruleForm.checkPass" autocomplete="off"></el-input>
</el-form-item>
......
</el-form>
<script>
export default {
data() {
......
var validatePass = (rule, value, callback) => {
if (value === '') {
callback(new Error('请输⼊密码'));
} else {
if (this.ruleForm.checkPass !== '') {
this.$refs.ruleForm.validateField('checkPass');
}
callback();
}
};
return {
ruleForm: {
pass: '',
checkPass: '',
age: ''
},
rules: {
pass: [
{ validator: validatePass, trigger: 'blur' }
],
......
}
};
},
......
}
</script>
如上，在data中定义表单验证规则的对象数组rules（可以单独编写验证器函数），并直接绑定到表单标签的rules参数中。
其中，validator是单个表单域格式验证的验证器，⼀般是需要⽐较复杂的格式验证的时候才会⽤。如果是⾮空验证、数据类型验证或者正则表达式能处理的，都可以直接通过rules的type/Pattern等相关参数直接配置就好了。
2.对单个表单域进⾏验证：
<el-form :model="dynamicValidateForm" ref="dynamicValidateForm" label-width="100px" class="demo-dynamic">
<el-form-item
label="邮箱"
prop="email"
:rules="[
{ required: true, message: '请输⼊邮箱地址', trigger: 'blur' },
{ type: 'email', message: '请输⼊正确的邮箱地址', trigger: ['blur', 'change'] }
]"
>
<el-input v-model="ail"></el-input>
</el-form-item>
<el-form-item
v-for="(domain, index) in dynamicValidateForm.domains" :label="'域名' + index" :key="domain.key"
:prop="'domains.' + index + '.value'"
:rules="{
required: true, message: '域名不能为空', trigger: 'blur'
}"
>
......
</el-form>
<script>
export default {
data() {
return {
dynamicValidateForm: {
domains: [{
value: ''
}],
email: ''
}
};
},
......
}
</script>
如上，对于单个表单域，可以直接对表单域的rules参数进⾏配置，来实现格式验证，这种⽅法⼀般⽐较适⽤于格式验证⽐较简单的情况。
如果需要进⾏验证的字段⽐较多，或者验证规则⽐较复杂，那么最好使⽤上边对整个表单进⾏验证的⽅式。
官⽅⽂档中的介绍太过粗略，下⾯单独介绍rules的⽤法，详细校验规则参见。
表单验证规则rules的详细⽤法：
结合Element UI的例⼦：
rules: {
name: [
{ required: true, message: '请输⼊活动名称', trigger: 'blur' },
{ min: 3, max: 5, message: '长度在 3 到 5 个字符', trigger: 'blur' }
],
region: [
{ required: true, message: '请选择活动区域', trigger: 'change' }
],
date1: [
{ type: 'date', required: true, message: '请选择⽇期', trigger: 'change' }
],
date2: [
{ type: 'date', required: true, message: '请选择时间', trigger: 'change' }
]
......
}
如上，rules中单个表单域校验规则可以包含多个数组，每个数组即是⼀条校验规则：
name: [
{ required: true, message: '请输⼊活动名称', trigger: 'blur' },
{ min: 3, max: 5, message: '长度在 3 到 5 个字符', trigger: 'blur' }
]
数组中的单个检验规则对象中包含required/message/trigger/min/max等参数，这些参数配合起来，可以完成我们以往要编写多⾏代码才能实现的校验功能。下⾯就详细介绍这些参数。
type:
表明要使⽤验证器的类型，类似数据格式检验，其中还有email、url、regexp、method等特定格式字段的验证。
使⽤这个，我们就可以对⼀些特定的字段进⾏校验，⽽不⽤再像以前⼀样写正则，做判断。
⽐如只需要配置 type:'email' 的规则就可以验证email了，验证器都已经封装好了这些功能，你只需调⽤就可以了，这也是。
可识别的类型值有：
string: 字符串类型（默认值）
number: 数字类型
boolean：布尔类型
method: 函数类型
regexp：正则表达式
integer: 整型
float: 双精度浮点型数字
array: 数组类型
object: 对象类型
enum: 枚举值
date: ⽇期格式
vue element admin
url: ⽹址格式
hex: 16进制数字
email: 电⼦邮箱格式
any: 任意类型
验证电⼦邮箱的完整⽰例代码：
email = [{
type: "string",
required: true,
message: '请输⼊邮箱地址',
trigger: 'blur'
},
{
type: 'email',
message: '请输⼊正确的邮箱地址',
trigger: ['blur', 'change']
}
]
如上，实现了⽂本框失去焦点进⾏⾮空检验，失去焦点、内容改变进⾏格式验证，并给出相应提⽰，是不是⽐我们以前⽤原⽣js来实现简单明了多了呢。
required：
必填字段，即⾮空验证。如上⾯实例中的的⾮空验证，以及邮箱前边的必填符号*，就是这个参数的功劳。
pattern：
正则表达式，如果需要验证⼿机号码之类，可以直接编写正则表达式配置到校验规则中，那么就不需要⾃⼰去校验了，由校验器⾃动校验。{ type : "string" , required: true , pattern : /^[a-z]+$/ }
min/max：
判断数据⼤⼩范围，通常对数字⼤⼩范围做校验。对于字符串和数组类型，将根据长度进⾏⽐较。
{ required: true, message: '请输⼊活动名称', trigger: 'blur' },
{ min: 3, max: 5, message: '长度在 3 到 5 个字符', trigger: 'blur' }
len：
长度验证，如11位⼿机号码。
roles: {
type: "array", required: true, len: 3
}
enum：
枚举值验证，⽰例代码如下：
role: {type: "enum", enum: ['admin', 'user', 'guest']}
whitespace:
验证是否只有空格(如果没有该配置，则全空格的输⼊值也是有效的）。
whitespace: [{
type: "string",
message: '只存在空格',
whitespace:true,
trigger: ['change', 'blur']
}]
transform：
有时有必要在验证之前转换值，以强制或以某种⽅式对其进⾏清理。为此transform，向验证规则添加⼀个功能。在验证之前，先转换属性，然后将其重新分配给源对象，以更改该属性的值。
// 校验
transform: [
{
type: 'enum',
enum: [2,4,6],
message: `结果不存在`,
trigger: ['change', 'blur'],
transform(value) {
return Number(value * 2)
}
}
]
如上，只有输⼊1、2、3的时候才能校验通过。
貌似这个只能辅助校验，并不能改变组件绑定变量本⾝的值。
fields:
深层规则，可以通过将嵌套规则分配给规则的属性来验证object或array类型的验证规则，如地址对象的省市区的规则验证：
object类型：
address: {
type: "object", required: true,
fields: {
street: {type: "string", required: true},
city: {type: "string", required: true},
zip: {type: "string", required: true, len: 8, message: "invalid zip"}
}
}
array类型：
roles: {
type: "array", required: true, len: 3,
fields: {
0: {type: "string", required: true},
1: {type: "string", required: true},
2: {type: "string", required: true}
}
}
messages:
未通过校验的提⽰信息：
{name:{type: "string", required: true, message: "Name is required"}}
⽀持html:
{name:{type: "string", required: true, message: "<b>Name is required</b>"}}
⽀持vue-i18n:
{name:{type: "string", required: true, message: () => this.$t( 'name is required' )}}
validator：
可以为指定字段⾃定义验证函数——这就相当于把前边配置的东西⽤js按照以前的⽅式编写验证逻辑了。虽然⿇烦点，但是能实现⽐较复杂的业务逻辑判断。
简单的⽤法：
field: {
validator(rule, value, callback) {
return value === 'test';
},
message: 'Value is not equal to "test".',
}
还可以这样⽤：
......
data() {
const checkAge = (rule, value, callback) => {
if(!value) {
return callback(new Error('年龄不能为空'));
}
setTimeout(() => {
if(!Number.isInteger(value)) {
callback(new Error('请输⼊数字值'));
} else {
if(value < 18) {
callback(new Error('必须年满18岁'));
} else {
callback();
}
}
}, 1000);
};
return {
ruleForm: {
age: 11
},
rules: {
age: [{
type: 'number',
required: true,
validator: checkAge,
trigger: ['blur', 'change']
}]
}
};
}
.
.....
获取验证结果：使⽤时直接调⽤⽅法即可
validate(): boolean {
let flag = true
// @ts-ignore
this.$refs['formData'].validate((valid: any) => {
if (valid) {
flag = true
} else {
flag = false
}
})
return flag
}
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论