本教程大家分享了自带气泡提示的vue校验插件,供大家参考,具体内容如下
安装
npm install vue-verify-pop
使用
VUE版本:1.x
必须在vue-cli生成的webpack模板环境中使用
一、在./main.js中执行全局配置
import vue from 'vue' import verify from 'vue-verify-pop' vue.use(verify) // 以下配置非必须,按你的需求来 // 配置默认校验不通过时的提示信息 verify.errMsg = YourErroMsg // 增加校验规则 verify.addRule('myRule', (v) => {return '校验不通过'})</div>
二、在表单元素中配置校验规则
<!--待校验元素的pop容器--> <pop> <!--该输入框内容为最多为两位小数的数字--> <input v-verify decimal-length="2"> </pop></div>
ok,您已经完成了一个基础校验。气泡提示怎么样?丑的话自己用css改吧。。
当输入框失去焦点时会自动触发校验,如果校验不通过会出现气泡。再次输入气泡会消失
支持的校验规则(继承verify-base.js)
- length: 校验文本长度
- minLength: 校验文本最短长度
- maxLength: 校验文本最长长度
- maxNumber: 校验数字最大值
- minNumber: 校验数字最小值
- decimalLength: 校验小数位
- number: 校验是否为数字
- int: 校验是否为整数
- phone: 校验是否为手机号
- idCard: 校验是否为身份证号
- bankCard: 校验是否为银行卡号
- email: 校验是否为电子邮件地址
- verifyCode: 校验是否为6位数字验证码
- canBeNull: 当参数为空时跳过校验,不会执行后面的校验规则(注意:自定义校验函数'verify'仍然会执行)
重要参数说明
注意:规则中不能有大写字母,用中划线分隔,同vue props属性设置规则
errMsg
用于自定义校验不通过提示
<pop> <input v-verify length="10" err-msg="请输入正确的卡号"> </pop></div>
maxNumber
注意小于和小于等于的写法
<!--该输入框内容必须为小于等于10的数字--> <pop> <input v-verify max-number="10"> </pop> <!--该输入框内容必须为小于10的数字,通过'!'来标识--> <pop> <input v-verify max-number="!10"> </pop></div>
minNumber
参考maxNumber配置
pop
用于设置气泡组件的位置。
默认情况下,插件会查找待校验元素的分发对象或父容器(父容器的父容器的父容器...)是否为pop组件,如果找到则使用之。
当待校验元素和气泡提示不再满足父子容器关系时,可以用如下方式去指定:
<!--当校验不通过时,气泡提示会出现在这个div上面--> <pop id="cardIdPop"> <div>我是一个div</div> </pop> <input v-verify length="10" err-msg="卡号不正确" pop="cardIdPop"></div>
noCache
用于禁止插件对校验结果的缓存。默认情况下,插件会缓存上次的校验结果,直到待校验元素的值发生变化
<pop> <input v-verify length="10" err-msg="卡号不正确" no-cache> </pop></div>
canBeNull
插件默认校验输入内容不为空,该参数一般用于如下情况,比如邀请码这种一般可以为空,不为空又需要校验的输入项
自定义校验方法verify始终会执行,主要考虑到该校验方法中的校验对象很可能不仅仅是输入框本身的值,故不应受该配置项的影响
<!--当邀请码不为空时才校验长度是否等于10--> <pop> <input v-verify length="10" err-msg="邀请码不正确" can-be-null> </pop></div>
watch
监听其他变量,触发自身校验。
一个常见例子:最少参与人数不能大于最多参与人数,当最少参与人数变化时应当触发最多参与人数的校验
<template> <pop> <input placeholder="最少参与人数" v-verify v-model="minNumber" v-verify int> </pop> <pop> <input placeholder="最多参与人数" v-verify v-model="minNumber" v-verify int :verify="verifyMaxNumber" :watch="minNumber"> </pop> </template> <script> export default{ data () { return { minNumber: '' } }, methods: { verifyMaxNumber (val) { if (val - this.minNumber < 0) return '最多参与人数不能小于最少参与人数' } } } </script></div>
规则简写
number/int/phone等无须设定值的规则可以直接:
<pop> <!--该输入框内容必须为手机号--> <input v-verify phone> </pop></div>
maxNumber/minNumber/decimalLength无须写number规则
<pop> <!--该输入框内容必须为不大于10的数字--> <input v-verify max-number="10"> <!--不用这么写--> <input v-verify number max-number="10"> </pop></div>
自定义校验方法
如果自带的校验方法满足不了您的需求,可以在校验规则中插入您自己的校验方法
<template> <pop> <!--通过给props.verify赋值来植入自定义校验--> <!--当length规则通过时才会执行自定义校验--> <input v-verify length="10" :verify="verifyCardId" err-msg="卡号不正确"> </pop> </template> <script> export default{ methods: { verifyCardId (val) { // val: 待校验的值 // 可以直接return校验不通过的提示 // if (val.substr(0,1) !== '0') return '卡号不正确' // 如果直接return true/false 校验不通过提示将使用errMsg或默认错误提示 // return val.substr(0,1) === '0' } } } </script></div>
自定义校验规则
和自定义校验方法的区别是这个适用于全局,等于增加插件自带的校验规则
// 新增校验是否为6位数字 val: 待校验的值 rule: 规则值。 // 校验是否为6位数字这种一般时不需要额外参数用来对比,所以rule参数用不到。校验文本长度,数字大小这种才会用到rule // <input v-verify length="6"> '6'会作为rule参数 var verifyBase = verify.verifyBase verify.addRule('number6', (val, rule) => { // 判断是否为6位数字 // 只需要关注错误的情况 返回默认出错提示即可 if (!verifyBase('number')(val).valid || !verifyBase('length')(val, 6)) return '请输入正确的6位数字' })</div>
调用
<!--校验不通过提示优先errMsg,然后才是您自定义规则中返回的默认出错提示--> <input v-verify number6 err-msg="请输入正确的6位数字验证码"></div>
手动触发校验&分组校验
<template> <pop> <!--给目标元素设置v-el--> <input v-verify length="10" err-msg="卡号1不正确" v-el:ipt> </pop> <pop> <!--给目标元素设置id--> <input v-verify length="10" err-msg="卡号2不正确" id="ipt"> </pop> <!--给目标元素设置组名--> <verify name="verifyGroup"> <pop> <input v-verify length="10" err-msg="卡号3不正确"> </pop>