Vuelidate

作者: GAJYA | 来源:发表于2018-06-21 17:50 被阅读0次

    Vuelidate

    Vuelidate是一款简单轻量级的基于模块的Vue.js验证插件。

    安装

    安装很简单,用npm来安装只需要一句话:

    npm install vuelidate --save
    npm i -S vuelidate               //简写
    

    使用

    在main.js中导入库并用作Vue插件,以便在包含验证配置的所有组件上全局启用该功能:

    import Vue from 'vue'
    import Vuelidate from 'vuelidate'
    
    Vue.use(Vuelidate)//安装插件
    

    内置验证规则

    • required: 需要非空数据。检查仅包含空格的空数组和字符串。
    • maxLength:要求输入具有最大指定长度(包括最大值)。适用于数组。
    • minLength:要求输入具有最小指定长度(包括最小值)。适用于数组。
    • email: 接受有效的电子邮件地址。请记住,您仍然需要在服务器上进行仔细验证,因为无法发送验证电子邮件地址是否是真实的。
    • between: 检查数字或日期是否在指定范围内。最小值和最大值都包括在内。
    • ipAddress: 接受点分十进制表示形式的有效IPv4地址,如127.0.0.1。
    • alpha: 只接受字母字符。
    • alphaNum: 只接受字母数字。
    • numeric: 只接受数字。
    • sameAs: 检查给定属性是否相等。
    • url: 只接受网址。
    • or: 当至少有一个提供的验证器通过时通过。
    • and: 所有提供的验证器都通过时通过。
    • requiredIf: 仅当提供的属性或谓词为真时才需要非空数据。
    • requiredUnless: 仅当提供的属性或谓词为假时才需要非空数据。
    • minValue: 要求输入具有指定的最小数值或日期。
    • maxValue: 要求输入具有指定的最大数值或日期。

    自定义验证规则(Custom Validators)

    除了使用Vuelidate自带的内置验证规则外还可以使用自定义规则满足需求。

    最简单的方法就是直接在当前文件的script里面设置校验规则,当然也可以单独的写一个my-validators.js的文件,无论是单独写还是抽离出来都需要引入.详情请参考 vuelidate的自定义验证规则

    import { regex } from 'vuelidate/lib/validators/common'
    或者
    import { helpers } from 'vuelidate/lib/validators'
    

    例子:

    register.vue

    //1. 先引入需要用到的验证规则
    import { required, maxLength, sameAs } from 'vuelidate/lib/validators'
    import { regex } from 'vuelidate/lib/validators/common'
    var phone = regex('phoneNumber', /^1(3|4|5|7|8)\d{9}$/) // 手机号码校验
    
    export default {
        data () {
            return {
                user: {
                    username: '',
                    password: '',
                    confirmPassword: '',
                    phone: '',
                    phoneCode: ''
                }
            }
        },
        // 2.定义验证字段的规则
        validations: {
            user: {
                username: {
                    required,
                    // minLength: minLength(2),
                    maxLength: maxLength(20),
                    async isUnique (value) { // 异步校验用户名是否已注册
                        if (value === '') return true
                        const response = await fetch(`/api/unique/name/${value}`)
                        return Boolean(await response.json())
                    }
                },
                password: {
                    required
                },
                confirmPassword: {
                    sameAsPassword: sameAs('password') // 校验密码是否一致
                },
                phone: {
                    required,
                    phone  // 直接就是用的上面const设置的校验规则,自定义校验
                },
                phoneCode: {
                    required
                }
            }
        }
    }
    
    

    register.vue的html部分

    <div :class="{ 'form-group--error': $v.user.password.$error }" >
        <input v-model.trim="$v.user.password.$model" 
               @blur="$v.user.password.$touch()" class="input-line" 
               type="password"  
               placeholder="请设置密码">
        <span class="form-group__message" v-if="!$v.user.password.required">密码不能为空</span>
    </div>
    <div :class="{ 'form-group--error': $v.user.confirmPassword.$error }">
        <input v-model.trim="$v.user.confirmPassword.$model" 
               class="input-line" type="password" 
               placeholder="请确认密码">
        <span class="form-group__message" 
              v-if="!$v.user.confirmPassword.sameAsPassword">两次输入的密码不一致</span>
    </div>
    <div :class="{ 'form-group--error': $v.user.phone.$error }">
        <input v-model.trim="$v.user.phone.$model" 
               @blur="$v.user.phone.$touch()" class="input-line" 
               placeholder="请输入手机号码">
        <span class="form-group__message" v-if="!$v.user.phone.required">手机号码不能为空</span>
        <span class="form-group__message" v-if="!$v.user.phone.phone">请输入正确的手机号码</span>
    </div>
    

    Register.vue的css部分

    /* 表单验证样式 */
    .form-group__message{
        display: none;
        font-size: 12px;
        color: #CC3333;
    }
    .form-group--error > input + .form-group__message {
        display: block;
        color: #CC3333;
    }
    .form-group--error input, .form-group--error input:focus, .form-group--error input:hover, .form-group--error textarea {
        border-color: #CC3333;
    }
    

    相关文章

      网友评论

        本文标题:Vuelidate

        本文链接:https://www.haomeiwen.com/subject/mkscyftx.html