这次来讲一下表单验证插件 VeeValidate,那为什么要结合 Vue 来讲呢?来看一下 github 上的图片就明白了!
为 Vue 而来的!不清楚是不是 Vue 的官方表单验证插件。
废话不多说直接显示效果:
===============================分隔线==================================
为什么需要用表单验证插件,想想自己重写过几次表单验证,重复造轮子相当的痛苦,当然你可以自己造一套通用的组件。我比较懒,表单验证就用现成的,VeeValidate 可扩展性也不错,所以就使用它来做表单验证。
jquery.validate 也是不错的选择,这是后话了,本文就只介绍 VeeValidate 在 Vue 中的实践。
1、安装
支持3中方式的引入项目
npm
npm install vee-validate --save
bower
bower install vee-validate#2.0.0-rc.4 --save
CDN
https://cdn.jsdelivr.net/vee-validate/2.0.0-rc.3/vee-validate.min.js
2、配置和使用
我是使用 npm 安装,注入依赖。这边配置使用主要是3个文件。
=====validate.js :自己创建一个文件,单独将关于表单验证的代码抽离出来,从 node_modules 中引入 VeeValidate,配置相关项
=====main.js :vue 主文件入口,引入validate.js
=====form.vue :表单组件
首先附上validate.js中的代码:
import Vue from 'vue'
import VeeValidate, {Validator} from 'vee-validate'
import zh from 'vee-validate/dist/locale/zh_CN';//引入中文文件
// 配置中文
Validator.addLocale(zh);
const config = {
locale: 'zh_CN'
};
Vue.use(VeeValidate,config);
// 自定义validate
const dictionary = {
zh_CN: {
messages: {
email: () => '请输入正确的邮箱格式',
required: ( field )=> "请输入" + field
},
attributes:{
email:'邮箱',
password:'密码',
name: '账号',
phone: '手机'
}
}
};
Validator.updateDictionary(dictionary);
Validator.extend('phone', {
messages: {
zh_CN:field => field + '必须是11位手机号码',
},
validate: value => {
return value.length == 11 && /^((13|14|15|17|18)[0-9]{1}\d{8})$/.test(value)
}
});
从上往下分别是:
1、引入表单验证依赖文件,并且引入的是支持中文错误提示的文件。
import Vue from 'vue'
import VeeValidate, {Validator} from 'vee-validate'
import zh from 'vee-validate/dist/locale/zh_CN';//引入中文文件
2、进行中文错误提示的配置。
// 配置中文
Validator.addLocale(zh);
const config = {
locale: 'zh_CN'
};
Vue.use(VeeValidate,config);
3、如果你想自定义表单验证的提示语,不配置有默认。
// 自定义validate
const dictionary = {
zh_CN: {
messages: {
email: () => '请输入正确的邮箱格式',
required: ( field )=> "请输入" + field
},
attributes:{
email:'邮箱',
password:'密码',
name: '账号',
phone: '手机'
}
}
};
Validator.updateDictionary(dictionary);
message : 提示语。
attributes: 就是 filed。
4、扩展自定义的验证,比如这边自定义了电话的表单验证。
Validator.extend('phone', {
messages: {
zh_CN:field => field + '必须是11位手机号码',
},
validate: value => {
return value.length == 11 && /^((13|14|15|17|18)[0-9]{1}\d{8})$/.test(value)
}
});
main.js中的代码:
import './static/js/validate.js'
只需要将 validate.js 引入主文件入口就完成了铺路工作,现在就可以开始写表单界面了。
form.vue 组件中的代码:
账户
{{ errors.first('name') }}
这是其中的一个 input 拿出来讲:
1、首先在 input 中你得有 name 属性。
2、v-validate 属性:管道形式进行过滤,验证条件。
3、span 就是错误提示 。
errors.first('field') -- 获取关于当前field的第一个错误信息
collect('field') -- 获取关于当前field的所有错误信息(list)
has('field') -- 当前filed是否有错误(true/false)
all() -- 当前表单所有错误(list)
any() -- 当前表单是否有任何错误(true/false)
到这边你可以完成基础的表单验证了,不同的项目都会有不同的需求,表单验证也不一样,但是 VeeValidate 支持你去扩展,完成各种不同的需求。你可以参照着官网文档,造一个自己的表单验证,这样不同项目时只需要进行简单的修改就能用上了。
VeeValidate 具备丰富的文档: