Vue2.0表单校验组件vee-validate的使用详解

Vue2.0表单校验组件vee-validate的使⽤详解
vee-validate使⽤教程
本⽂适合有⼀定Vue2.0基础的同学参考，根据项⽬的实际情况来使⽤，关于Vue的使⽤不做多余解释。

本⼈也是⼀边学习⼀边使⽤，如果错误之处敬请批评指出*
⼀、安装
npm install vee-validate@next --save
注意：@next,不然是Vue1.0版本
bower install vee-validate#2.0.0-beta.13 --save
⼆、引⽤
import Vue from 'vue';
import VeeValidate from 'vee-validate';
e(VeeValidate);
组件设置:
import VeeValidate, { Validator } from 'vee-validate';
import messages from 'assets/js/zh_CN';
Validator.updateDictionary({
zh_CN: {
messages
}
});
const config = {
errorBagName: 'errors', // change if property conflicts.
delay: 0,
locale: 'zh_CN',
messages: null,
strict: true
};
e(VeeValidate,config);
assets/js/zh_CN 代表你存放语⾔包的⽬录，从node_modules/vee-validate/dist/locale⽬录下⾯拷贝到你的项⽬
Validator还有更多应⽤，下⾯再讲。

config其它参数，delay代表输⼊多少ms之后进⾏校验，messages代表⾃定义校验信息，strict=true代表没有设置规则的表单不进⾏校验，errorBagName属于⾼级应⽤，⾃定义errors，待研究
三、基础使⽤
<div class="column is-12">
<label class="label" for="email">Email</label>
<p class="control">
<input v-validate data-rules="required|email" :class="{'input': true, 'is-danger': errors.has('email') }" name="email" type="text" placeholder="Email">
<span v-show="errors.has('email')" class="help is-danger">{{ errors.first('email') }}</span>
</p>
</div>
提醒：错误信息⾥⾯的名称通常就是表单的name属性，除⾮是通过Vue实例传递进来的。

提醒：养成好习惯，给每个field添加name属性，如果没有name属性⼜没有对值进⾏绑定的话，validator可能不会对其进⾏正确的校验
关于errors：
上⾯的代码我们看到有errors.has,errors.first,errors是组件内置的⼀个数据模型，⽤来存储和处理错误信息，可以调⽤以下⽅法：
1. errors.first('field') - 获取关于当前field的第⼀个错误信息
2. collect('field') - 获取关于当前field的所有错误信息(list)
3. has('field') - 当前filed是否有错误(true/false)
4. all() - 当前表单所有错误(list)
5. any() - 当前表单是否有任何错误(true/false)
6. add(String field, String msg) - 添加错误
7. clear() - 清除错误
8. count() - 错误数量
9. remove(String field) - 清除指定filed的所有错误
关于Validator
Validator是以$validator被组件⾃动注⼊到Vue实例的。

同时也可以独⽴的进⾏调⽤，⽤来⼿动检查表单是否合法,以传⼊⼀个对象的⽅式，遍历其中指定的field。

import { Validator } from 'vee-validate';
const validator = new Validator({
email: 'required|email',
name: 'required|alpha|min:3',
});
// or Validator.create({ ... });
你也可以在构造了validator之后设置对象参数
import { Validator } from 'vee-validate';
const validator = new Validator();
validator.attach('email', 'required|email'); // attach field.
validator.attach('name', 'required|alpha', 'Full Name'); // attach field with display name for error generation.
validator.detach('email'); // you can also detach fields.
最后你也可以直接传值给field，测试是否可以通过校验，像这样：
validator.validate('email', 'foo@'); // true
validator.validate('email', 'foo@bar'); // false
//或者同时校验多个:
validator.validateAll({
email: 'foo@',
name: 'John Snow'
});
//只要有⼀个校验失败了，就返回false
四、内置的校验规则
1. after{target} - ⽐target要⼤的⼀个合法⽇期，格式(DD/MM/YYYY)
2. alpha - 只包含英⽂字符
3. alpha_dash - 可以包含英⽂、数字、下划线、破折号
4. alpha_num - 可以包含英⽂和数字
5. before:{target} - 和after相反
6. between:{min},{max} - 在min和max之间的数字
7. confirmed:{target} - 必须和target⼀样
8. date_between:{min,max} - ⽇期在min和max之间
9. date_format:{format} - 合法的format格式化⽇期
10. decimal:{decimals?} - 数字，⽽且是decimals进制
11. digits:{length} - 长度为length的数字
12. dimensions:{width},{height} - 符合宽⾼规定的图⽚
13. email - 不解释
14. ext:[extensions] - 后缀名
15. image - 图⽚
16. in:[list] - 包含在数组list内的值
17. ip - ipv4地址
18. max:{length} - 最⼤长度为length的字符
19. mimes:[list] - ⽂件类型
20. min - max相反
21. mot_in - in相反
22. numeric - 只允许数字
23. regex:{pattern} - 值必须符合正则pattern
24. required - 不解释
25. size:{kb} - ⽂件⼤⼩不超过
26. url:{domain?} - (指定域名的)url
五、⾃定义校验规则
1.直接定义
const validator = (value, args) => {
// Return a Boolean or a Promise.
}
//最基本的形式，只返回布尔值或者Promise，带默认的错误提⽰
2.对象形式
const validator = {
getMessage(field, args) { // 添加到默认的英⽂错误消息⾥⾯
// Returns a message.
},
validate(value, args) {
// Returns a Boolean or a Promise.
}
};
3.添加到指定语⾔的错误消息
const validator = {
messages: {
en: (field, args) => {
// 英⽂错误提⽰
},
cn: (field, args) => {
// 中⽂错误提⽰
}
},
validate(value, args) {
// Returns a Boolean or a Promise.
}
};
创建了规则之后，⽤extend⽅法添加到Validator⾥⾯
import { Validator } from 'vee-validate';
const isMobile = {
messages: {
en:(field, args) => field + '必须是11位⼿机号码',
},
validate: (value, args) => {
return value.length == 11 && /^((13|14|15|17|18)[0-9]{1}\d{8})$/.test(value)
}
}
Validator.extend('mobile', isMobile);
//或者直接
Validator.extend('mobile', {
messages: {
en:field => field + '必须是11位⼿机号码',
},
validate: value => {
return value.length == 11 && /^((13|14|15|17|18)[0-9]{1}\d{8})$/.test(value)
}
});
然后接可以直接把mobile当成内置规则使⽤了：
<input v-validate data-rules="required|mobile" :class="{'input': true, 'is-danger': errors.has('mobile') }" name="mobile" type="text" placeholder="Mobile"> <span v-show="errors.has('mobile')" class="help is-danger">{{ errors.first('mobile') }}</span>
4.⾃定义内置规则的错误信息
import { Validator } from 'vee-validate';
const dictionary = {
en: {
messages: {
alpha: () => 'Some English Message'
}
},
cn: {
messages: {
alpha: () => '对alpha规则的错误定义中⽂描述'
}
}
};
Validator.updateDictionary(dictionary);
暂时介绍到这⾥，应该已经上⼿了，有空再继续翻译。

其它问题或者更⾼级应⽤，请参考官⽅⽂档
以上就是本⽂的全部内容，希望对⼤家的学习有所帮助，也希望⼤家多多⽀持。