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){
            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>

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

效果如图


posted @ 2016-07-28 14:24  帅气的皮卡丘  阅读(134602)  评论(26编辑  收藏  举报