官方文档:http://vuejs.github.io/vue-validator/zh-cn/index.html
github项目地址:https://github.com/vuejs/vue-validator
单独使用vue-validator的方法见官方文档,本文结合vue-router使用。
安装验证器
不添加自定义验证器或者无需全局使用的公用验证器,在main.js中安装验证器,使用 CommonJS 模块规范, 需要显式的使用 Vue.use()
安装验证器组件。
import Validator from 'vue-validator'
Vue.use(Validator)
与 vue-router 同时使用,必须在调用 router#map, router#start 等实例方法前安装验证。
若要自定义验证器,建一个js文件,在该文件中安装验证器组件。例如:validation.js
import Vue from 'vue' import Validator from 'vue-validator' Vue.use(Validator) //自定义验证器
自定义验证器
官方提供的api如下
input[type="text"] input[type="radio"] input[type="checkbox"] input[type="number"] input[type="password"] input[type="email"] input[type="tel"] input[type="url"] select textarea
但是以上的不一定满足我们的需求,这时就需要用到另一个全局api,用于注册和获取全局验证器。
Vue.validator( id, [definition] )
示例 定义validation.js 内容如下
import Vue from 'vue' import Validator from 'vue-validator' Vue.use(Validator)
//自定义验证器 //添加一个简单的手机号验证 //匹配0-9之间的数字,并且长度是11位 Vue.validator('tel', function (val) { return /^[0-9]{11}$/.test(val) }); //添加一个密码验证 //匹配6-20位的任何字类字符,包括下划线。与“[A-Za-z0-9_]”等效。 Vue.validator('passw', function (val) { return /^(\w){6,20}$/.test(val) });
使用验证器
验证器语法
<validator name="validation"> <input type="text" v-model='comment' id='comment' v-validate:comment="{ minlength: 3, maxlength: 15 }"> <div> <span v-show="$validation.comment.minlength">不得少于3个字符</span> <span v-show="$validation.comment.maxlength">不得大于15个字符</span> </div> </validator>
默认情况下,vue-validator
会根据 validator
和 v-validate
指令自动进行验证。然而有时候我们需要关闭自动验证,在有需要时手动触发验证。如果你不需要自动验证,可以通过 initial
属性或 v-validate
验证规则来关闭自动验证。如下:
<validator name="validation"> <input type="text" v-model='comment' id='comment' v-validate:comment="{ minlength: 3, maxlength: 15 }" detect-change="off" initial='off'> <div> <span v-show="$validation.comment.minlength">不得少于3个字符</span> <span v-show="$validation.comment.maxlength">不得大于15个字符</span> </div> </validator>
Terminal 指令问题
<validator name="test_validator"> <!-- @invalid:valid的逆 ,表示验证不通过 --> <input @invalid="passwInvalid" @valid="passwok" type="password" v-model='passw' id='passw' v-validate:passw="['passw']" detect-change="off" initial='off' placeholder='请输入密码'> <input @invalid="passwInvalid" @valid="passwok" type="password" v-model='passw2' id='passw2' v-validate:passw2="['passw']" detect-change="off" initial='off' placeholder='请输入密码'> </validator> <script> //若是在main.js中导入 无需再次导入
//此处导入的是上面代码的validation.js
import validator from '../validator/validation' export default{ data(){ return{ comment:'', passw:'', passw2:'' } }, methods:{ passwInvalid(){ alert('只能输入6-20个字母、数字、下划线'); }, passwok(){ //alert('验证码符合规范') } } } </script>
示例:用户注册验证
用了一个组件来显示提示信息
toast.vue
<template> <div v-show="toastshow" transition="toast" class="toast font-normal"> {{toasttext}} </div> </template> <script> export default{ props:{ //是否显示提示 toastshow:{ type:Boolean, required: false, default:function(){ return false; } }, //提示的内容 toasttext:{ type:String, required: false, default:function(){ return 'no message'; } }, //显示的时间 duration: { type: Number, default:3000,//默认3秒 required:false } }, ready() { }, watch:{ toastshow(val){ if (this._timeout) clearTimeout(this._timeout) if (val && !!this.duration) { this._timeout = setTimeout(()=> this.toastshow = false, this.duration) } } } } </script> <style> .toast{ position:absolute; left:50%; margin-left:-25%; bottom:30px; display:block; width:200px; height:auto; text-align:center; color:white; background-color:rgba(0,0,0,0.5); border-radius:10px; z-index:10; transform:scale(1); padding:5px; } .toast-transition{ transition: all .3s ease; } .toast-enter{ opacity:0; transform:scale(0.1); } .toast-leave{ opacity:0; transform:scale(0.1); } </style>
注册用户:假如我们需要填写手机号和输入两次密码
<template> <div class='register-box'> <!-- 组件:用于显示提示信息 --> <Toast :toastshow.sync="toastshow" :toasttext="toasttext"></Toast> <validator name="validation_register1"> <div class='register1'> <div class='pd05'> <input @invalid="telonInvalid" initial="off" detect-change="off" v-model="telphone" id="telphone" type="tel" class='phone-number' v-validate:telphone="['tel']" placeholder='请输入手机号码'> </div> <div class='pd05'> <input @invalid="passwInvalid" v-model="passw1" initial="off" detect-change="off" id="passw1" type="password" v-validate:passw1="['passw']" class='password-number' placeholder='请输入密码'> </div> <div class='pd05'> <input @invalid="passwInvalid" v-model="passw2" initial="off" detect-change="off" id="passw2" type="password" v-validate:passw2="['passw']" class='password-number' placeholder='请输入密码'> </div> <a class='greenBtn' v-on:click='register_user()'>下一步</a> </div> </validator> </div> </template> <script> //导入validation.js 此处的validation.js就是上文中validation.js的内容 import validator from '../validator/validation'; //导入显示提示信息的组件 import Toast from '../components/toast.vue'; export default{ components: { //注册组件 Toast }, data(){ return{ telphone:'',//电话号码 toastshow:false,//默认不现实提示信息 toasttext:'',//提示信息内容 passw1:'',//首次输入密码 passw2:''//再次输入密码 } }, methods:{ //手机号验证失败时执行的方法 telonInvalid(){ //设置提示信息内容 this.$set('toasttext','手机不正确'); //显示提示信息组件 this.$set('toastshow',true); }, //密码验证失败时执行的方法 passwInvalid(){ this.$set('toasttext','只能输入6-20个字母、数字、下划线'); this.$set('toastshow',true); }, register_user(){ var that = this; var telephones = that.$get('telphone'); var pw1 = that.$get('passw1'); var pw2 = that.$get('passw2') that.$validate(true, function () { if (that.$validation_register1.invalid) { //验证无效 that.$set('toasttext','请完善表单'); that.$set('toastshow',true); }else{ that.$set('toasttext','验证通过'); that.$set('toastshow',true); //验证通过做注册请求 /*that.$http.post('http://192.168.30.235:9999/rest/user/register',{'account':telephones,'pwd':pw1,'pwd2':pw2}).then(function(data){ if(data.data.code == '0'){ that.$set('toasttext','注册成功'); that.$set('toastshow',true); }else{ that.$set('toasttext','注册失败'); that.$set('toastshow',true); } },function(error){ //显示返回的错误信息 that.$set('toasttext',String(error.status)); that.$set('toastshow',true); })*/ } }) } } } </script> <style> .register-box{ padding: 10px; } .pd05{ margin-top: 5px; } .greenBtn{ width: 173px; height: 30px; text-align: center; line-height: 30px; background: red; color: #fff; margin-top: 5px; } </style>
若点击下一步,会提示“请完善表单”,因为验证不通过;若是文本框获得焦点后失去焦点则会提示相应的错误信息;若内容填写正确,则会提示验证通过并发送相应的请求。
效果如图