vue-validator(vue验证器)

官方文档: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){
        </span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 255, 1)">if</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)"> (</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 255, 1)">this</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">._timeout) clearTimeout(</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 255, 1)">this</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">._timeout)
        </span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 255, 1)">if</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)"> (val </span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">&amp;&amp;</span> <span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">!!</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 255, 1)">this</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">.duration) {
         </span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 255, 1)">this</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">._timeout </span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">=</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)"> setTimeout(()</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">=&gt;</span> <span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 255, 1)">this</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">.toastshow </span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">=</span> <span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 255, 1)">false</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">, </span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 255, 1)">this</span><span style="background-color: rgba(245, 245, 245, 1); color: rgba(0, 0, 0, 1)">.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>

若点击下一步,会提示“请完善表单”,因为验证不通过;若是文本框获得焦点后失去焦点则会提示相应的错误信息;若内容填写正确,则会提示验证通过并发送相应的请求。

效果如图