Vue2.0表单校验组件vee-validate的使用详解

vee-validate使用教程

本文适合有一定Vue2.0基础的同学参考，根据项目的实际情况来使用，关于Vue的使用不做多余解释。本人也是一边学习一边使用，如果错误之处敬请批评指出*

一、安装

npm install vee-validate@next --save

注意：@next,不然是Vue1.0版本

bower install vee-validate#2.0.0-beta.13 --save

二、引用

import Vue from 'vue';
import VeeValidate from 'vee-validate';
Vue.use(VeeValidate);

组件设置:

import VeeValidate, { Validator } from 'vee-validate';
import messages from 'assets/js/zh_CN';
Validator.updateDictionary({
  zh_CN: {
    messages
  }
});
const config = {
  errorBagName: 'errors', // change if property conflicts.
  delay: 0,
  locale: 'zh_CN',
  messages: null,
  strict: true
};
Vue.use(VeeValidate,config);

assets/js/zh_CN 代表你存放语言包的目录，从node_modules/vee-validate/dist/locale目录下面拷贝到你的项目

Validator还有更多应用，下面再讲。

config其它参数，delay代表输入多少ms之后进行校验，messages代表自定义校验信息，strict=true代表没有设置规则的表单不进行校验，errorBagName属于高级应用，自定义errors，待研究

三、基础使用

<div class="column is-12">
  <label class="label" for="email">Email</label>
  <p class="control">
    <input v-validate data-rules="required|email" :class="{'input': true, 'is-danger': errors.has('email') }" name="email" type="text" placeholder="Email">
    <span v-show="errors.has('email')" class="help is-danger">{{ errors.first('email') }}</span>
  </p>
</div>

提醒：错误信息里面的名称通常就是表单的name属性，除非是通过Vue实例传递进来的。

提醒：养成好习惯，给每个field添加name属性，如果没有name属性又没有对值进行绑定的话，validator可能不会对其进行正确的校验

关于errors：

上面的代码我们看到有errors.has,errors.first,errors是组件内置的一个数据模型，用来存储和处理错误信息，可以调用以下方法：

1. errors.first('field') - 获取关于当前field的第一个错误信息
2. collect('field') - 获取关于当前field的所有错误信息(list)
3. has('field') - 当前filed是否有错误(true/false)
4. all() - 当前表单所有错误(list)
5. any() - 当前表单是否有任何错误(true/false)
6. add(String field, String msg) - 添加错误
7. clear() - 清除错误
8. count() - 错误数量
9. remove(String field) - 清除指定filed的所有错误

关于Validator

Validator是以$validator被组件自动注入到Vue实例的。同时也可以独立的进行调用，用来手动检查表单是否合法,以传入一个对象的方式，遍历其中指定的field。

import { Validator } from 'vee-validate';
const validator = new Validator({
  email: 'required|email',
  name: 'required|alpha|min:3',
}); 
// or Validator.create({ ... });

你也可以在构造了validator之后设置对象参数

import { Validator } from 'vee-validate';
const validator = new Validator();

validator.attach('email', 'required|email'); // attach field.
validator.attach('name', 'required|alpha', 'Full Name'); // attach field with display name for error generation.

validator.detach('email'); // you can also detach fields.

最后你也可以直接传值给field，测试是否可以通过校验，像这样：

validator.validate('email', 'foo@bar.com'); // true
validator.validate('email', 'foo@bar'); // false
//或者同时校验多个:
validator.validateAll({
  email: 'foo@bar.com',
  name: 'John Snow'
});
//只要有一个校验失败了，就返回false

四、内置的校验规则

1. after{target} - 比target要大的一个合法日期，格式(DD/MM/YYYY)
2. alpha - 只包含英文字符
3. alpha_dash - 可以包含英文、数字、下划线、破折号
4. alpha_num - 可以包含英文和数字
5. before:{target} - 和after相反
6. between:{min},{max} - 在min和max之间的数字
7. confirmed:{target} - 必须和target一样
8. date_between:{min,max} - 日期在min和max之间
9. date_format:{format} - 合法的format格式化日期
10. decimal:{decimals?} - 数字，而且是decimals进制
11. digits:{length} - 长度为length的数字
12. dimensions:{width},{height} - 符合宽高规定的图片
13. email - 不解释
14. ext:[extensions] - 后缀名
15. image - 图片
16. in:[list] - 包含在数组list内的值
17. ip - ipv4地址
18. max:{length} - 最大长度为length的字符
19. mimes:[list] - 文件类型
20. min - max相反
21. mot_in - in相反
22. numeric - 只允许数字
23. regex:{pattern} - 值必须符合正则pattern
24. required - 不解释
25. size:{kb} - 文件大小不超过
26. url:{domain?} - (指定域名的)url

五、自定义校验规则

1.直接定义

const validator = (value, args) => {
  // Return a Boolean or a Promise.
}
//最基本的形式，只返回布尔值或者Promise，带默认的错误提示

2.对象形式

const validator = {
  getMessage(field, args) { // 添加到默认的英文错误消息里面
    // Returns a message.
  },
  validate(value, args) {
    // Returns a Boolean or a Promise.
  }
};

3.添加到指定语言的错误消息

const validator = {
  messages: {
    en: (field, args) => {
      // 英文错误提示
    },
    cn: (field, args) => {
      // 中文错误提示
    }
  },
  validate(value, args) {
    // Returns a Boolean or a Promise.
  }
};

创建了规则之后，用extend方法添加到Validator里面

import { Validator } from 'vee-validate';
const isMobile = {
  messages: {
    en:(field, args) => field + '必须是11位手机号码',
  },
  validate: (value, args) => {
    return value.length == 11 && /^((13|14|15|17|18)[0-9]{1}\d{8})$/.test(value)
  }
}
Validator.extend('mobile', isMobile);

//或者直接

Validator.extend('mobile', {
  messages: {
   en:field => field + '必须是11位手机号码',
  },
  validate: value => {
   return value.length == 11 && /^((13|14|15|17|18)[0-9]{1}\d{8})$/.test(value)
  }
});

然后接可以直接把mobile当成内置规则使用了：

<input v-validate data-rules="required|mobile" :class="{'input': true, 'is-danger': errors.has('mobile') }" name="mobile" type="text" placeholder="Mobile">
<span v-show="errors.has('mobile')" class="help is-danger">{{ errors.first('mobile') }}</span>

4.自定义内置规则的错误信息

import { Validator } from 'vee-validate';

const dictionary = {
  en: {
    messages: {
      alpha: () => 'Some English Message'
    }
  },
  cn: {
    messages: {
      alpha: () => '对alpha规则的错误定义中文描述'
    }
  }
};

Validator.updateDictionary(dictionary);

暂时介绍到这里，应该已经上手了，有空再继续翻译。

其它问题或者更高级应用，请参考官方文档Vee-Validate

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# Vue2  # vee  # validate  # vue  # vee校验组件内部  # Vue引用vee-validate插件表单验证问题(cdn方式引用)  # Vue vee-validate插件的简单使用  # vue.js表单验证插件(vee-validate)的使用教程详解  # Vue.js + Nuxt.js 项目中使用 Vee-validate 表单校验  # vee-validate vue 2.0自定义表单验证的实例  # Vue中使用vee-validate表单验证的方法  # Vue3(ts)使用vee-validate表单校验  # 自定义全局验证规则说明  # 英文  # 表单  # 错误信息  # 自定义  # 错误提示  # 可以直接  # 长度为  # 第一个  # 多个  # 你也  # 之处  # 遍历  # 下划线  # 有一定  # 可以通过  # 对其  # 如果没有  # 不超过  # 不做  # 实际情况 

相关文章： 网站插件制作软件免费下载,网页视频怎么下到本地插件？  网站制作的步骤包括,正确网址格式怎么写？  制作网站的网址是什么,请问后缀为.com和.com.cn还有.cn的这三种网站是分别是什么类型的网站？  建站之星价格显示格式升级，你的预算足够吗？  如何快速搭建响应式可视化网站？  网站制作费用多少钱,一个网站的运营，需要哪些费用？  建站之星代理如何获取技术支持？  网站制作公司,橙子建站是合法的吗？  网站好制作吗知乎,网站开发好学吗？有什么技巧？  长沙企业网站制作哪家好,长沙水业集团官方网站？  c# Task.Yield 的作用是什么 它和Task.Delay(1)有区别吗  php能控制zigbee模块吗_php通过串口与cc2530 zigbee通信【介绍】  建站之星上传入口如何快速找到？  外汇网站制作流程,如何在工商银行网站上做外汇买卖？  如何确保西部建站助手FTP传输的安全性？  惠州网站建设制作推广,惠州市华视达文化传媒有限公司怎么样？  专业公司网站制作公司,用什么语言做企业网站比较好？  如何在腾讯云服务器上快速搭建个人网站？  建站主机与服务器功能差异如何区分？  如何用y主机助手快速搭建网站？  建站中国官网：模板定制+SEO优化+建站流程一站式指南  制作网站的软件下载免费,今日头条开宝箱老是需要下载怎么回事？  Android自定义控件实现温度旋转按钮效果  如何零成本快速生成个人自助网站？  Java解压缩zip - 解压缩多个文件或文件夹实例  html制作网站的步骤有哪些,iapp如何添加网页？  公司网站的制作公司,企业网站制作基本流程有哪些？  ,sp开头的版面叫什么？  如何在IIS中新建站点并配置端口与物理路径？  香港服务器网站生成指南：免费资源整合与高速稳定配置方案  如何在橙子建站上传落地页？操作指南详解  上海网站制作网站建设公司,建筑电工证网上查询系统入口？  娃派WAP自助建站：免费模板+移动优化，快速打造专业网站  JS中使用new Date(str)创建时间对象不兼容firefox和ie的解决方法(两种)  建站之星好吗？新手能否轻松上手建站？  如何通过PHP快速构建高效问答网站功能？  ,石家庄四十八中学官网？  实例解析Array和String方法  如何选择高效便捷的WAP商城建站系统？  广州美橙建站如何快速搭建多端合一网站？  做企业网站制作流程,企业网站制作基本流程有哪些？  建站主机选哪种环境更利于SEO优化？  如何在宝塔面板中创建新站点？  建站主机选购指南与交易推荐：核心配置解析  哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做？  网站建设制作、微信公众号,公明人民医院怎么在网上预约？  网站制作网站,深圳做网站哪家比较好？  rsync同步时出现rsync: failed to set times on “xxxx”: Operation not permitted  如何通过云梦建站系统实现SEO快速优化？  香港服务器部署网站为何提示未备案？