jyichen

官方文档: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>

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

效果如图


分类:

技术点:

相关文章: