为什么需要用表单验证插件,想想自己重写过几次表单验证,重复造轮子相当的痛苦,当然你可以自己造一套通用的组件。我比较懒,表单验证就用现成的,VeeValidate 可扩展性也不错,所以就使用它来做表单验证。
jquery.validate 也是不错的选择,这是后话了,本文就只介绍 VeeValidate 在 Vue 中的实践。
基本示例(官方说明)
您所需要的只是将
v-validate
指令添加到要验证的输入中,并确保您的输入具有name
用于生成错误消息的属性。然后,传递给指令一个
rules
字符串,其中包含由管道' |
' 分隔的验证规则列表。对于以下示例,验证规则很简单。使用required
表明,该领域是必需的,email
以表明该字段必须为电子邮件。要结合这两个规则,我们指定字符串值required|email
的v-validate
表达式的值。<input v-validate="'required|email'" name="email" type="text">
要显示错误消息,我们只需使用该
errors.first
方法来获取为该字段生成的第一个错误:<span>{{ errors.first('email') }}</span>
1、安装(个人博客说明)
npm install vee-validate --save
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 组件中的代码:
<div class="layui-form-item">
<label class="layui-form-label">账户</label>
<div class="layui-block">
<input v-model="name" v-validate="'required|min:3|alpha'" :class="{'input': true, 'is-danger': errors.has('name') }" type="text" name="name" class="layui-input" placeholder="账户">
<span v-show="errors.has('name')" class="text-style" v-cloak> {{ errors.first('name') }} </span>
</div>
</div>
这是其中的一个 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 支持你去扩展,完成各种不同的需求。你可以参照着官网文档,造一个自己的表单验证,这样不同项目时只需要进行简单的修改就能用上了。
内置的校验规则
after{target}
- 比target要大的一个合法日期,格式(DD/MM/YYYY)alpha
- 只包含英文字符alpha_dash
- 可以包含英文、数字、下划线、破折号alpha_num
- 可以包含英文和数字before:{target}
- 和after相反between:{min},{max}
- 在min和max之间的数字confirmed:{target}
- 必须和target一样date_between:{min,max}
- 日期在min和max之间date_format:{format}
- 合法的format格式化日期decimal:{decimals?}
- 数字,而且是decimals进制digits:{length}
- 长度为length的数字dimensions:{width},{height}
- 符合宽高规定的图片email
- 不解释ext:[extensions]
- 后缀名image
- 图片in:[list]
- 包含在数组list内的值ip
- ipv4地址max:{length}
- 最大长度为length的字符mimes:[list]
- 文件类型min
- max相反mot_in
- in相反numeric
- 只允许数字regex:{pattern}
- 值必须符合正则patternrequired
- 不解释size:{kb}
- 文件大小不超过url:{domain?}
- (指定域名的)url
来源:CSDN
作者:莫普斯
链接:https://blog.csdn.net/qq_14988399/article/details/80678317