Vue+表单验证 VeeValidate 实践

岁酱吖の 提交于 2019-12-06 10:43:31
为什么需要用表单验证插件,想想自己重写过几次表单验证,重复造轮子相当的痛苦,当然你可以自己造一套通用的组件。我比较懒,表单验证就用现成的,VeeValidate 可扩展性也不错,所以就使用它来做表单验证。
  jquery.validate 也是不错的选择,这是后话了,本文就只介绍 VeeValidate 在 Vue 中的实践。

基本示例(官方说明)

您所需要的只是将v-validate指令添加到要验证的输入中,并确保您的输入具有name用于生成错误消息的属性。
然后,传递给指令一个rules字符串,其中包含由管道' |' 分隔的验证规则列表。对于以下示例,验证规则很简单。使用required表明,该领域是必需的,email以表明该字段必须为电子邮件。要结合这两个规则,我们指定字符串值required|emailv-validate表达式的值。
<input v-validate="'required|email'" name="email" type="text">
要显示错误消息,我们只需使用该errors.first方法来获取为该字段生成的第一个错误:
<span>{{ errors.first('email') }}</span>

1、安装(个人博客说明)

npm install vee-validate --save

2、配置和使用

  我是使用 npm 安装,注入依赖。这边配置使用主要是3个文件。
=====validate.js :自己创建一个文件,单独将关于表单验证的代码抽离出来,从 node_modules 中引入 VeeValidate,配置相关项 =====main.js :vue 主文件入口,引入validate.js =====form.vue :表单组件
首先附上validate.js中的代码:
import Vue from 'vue'
import VeeValidate, {Validator} from 'vee-validate'
import zh from 'vee-validate/dist/locale/zh_CN';//引入中文文件

// 配置中文
Validator.addLocale(zh);

const config = {
  locale: 'zh_CN'
};

Vue.use(VeeValidate,config);

// 自定义validate 
const dictionary = {
   zh_CN: {
      messages: {
        email: () => '请输入正确的邮箱格式',
        required: ( field )=> "请输入" + field
      },
      attributes:{
        email:'邮箱',
        password:'密码',
        name: '账号',
        phone: '手机'
      }
  }
};

Validator.updateDictionary(dictionary);

Validator.extend('phone', {
  messages: {
    zh_CN:field => field + '必须是11位手机号码',
  },
  validate: value => {
    return value.length == 11 && /^((13|14|15|17|18)[0-9]{1}\d{8})$/.test(value)
  }
});
从上往下分别是:
1、引入表单验证依赖文件,并且引入的是支持中文错误提示的文件。
import Vue from 'vue'
import VeeValidate, {Validator} from 'vee-validate'
import zh from 'vee-validate/dist/locale/zh_CN';//引入中文文件
2、进行中文错误提示的配置。
// 配置中文
Validator.addLocale(zh);

const config = {
  locale: 'zh_CN'
};

Vue.use(VeeValidate,config);
3、如果你想自定义表单验证的提示语,不配置有默认。
// 自定义validate 
const dictionary = {
   zh_CN: {
      messages: {
        email: () => '请输入正确的邮箱格式',
        required: ( field )=> "请输入" + field
      },
      attributes:{
        email:'邮箱',
        password:'密码',
        name: '账号',
        phone: '手机'
      }
  }
};

Validator.updateDictionary(dictionary);
message : 提示语。 attributes: 就是 filed。
4、扩展自定义的验证,比如这边自定义了电话的表单验证。
Validator.extend('phone', {
  messages: {
    zh_CN:field => field + '必须是11位手机号码',
  },
  validate: value => {
    return value.length == 11 && /^((13|14|15|17|18)[0-9]{1}\d{8})$/.test(value)
  }
});
main.js中的代码:
import './static/js/validate.js'
只需要将 validate.js 引入主文件入口就完成了铺路工作,现在就可以开始写表单界面了。
form.vue 组件中的代码:
<div class="layui-form-item">
    <label class="layui-form-label">账户</label>
    <div class="layui-block">
        <input v-model="name" v-validate="'required|min:3|alpha'" :class="{'input': true, 'is-danger': errors.has('name') }" type="text" name="name" class="layui-input" placeholder="账户">
        <span v-show="errors.has('name')" class="text-style" v-cloak> {{ errors.first('name') }} </span>
    </div>
</div>
这是其中的一个 input 拿出来讲:
1、首先在 input 中你得有 name 属性。
2、v-validate 属性:管道形式进行过滤,验证条件。
3、span 就是错误提示 。
errors.first('field') -- 获取关于当前field的第一个错误信息
collect('field') -- 获取关于当前field的所有错误信息(list)
has('field') -- 当前filed是否有错误(true/false)
all() -- 当前表单所有错误(list)
any() -- 当前表单是否有任何错误(true/false)
  到这边你可以完成基础的表单验证了,不同的项目都会有不同的需求,表单验证也不一样,但是 VeeValidate 支持你去扩展,完成各种不同的需求。你可以参照着官网文档,造一个自己的表单验证,这样不同项目时只需要进行简单的修改就能用上了。

内置的校验规则

  • after{target} - 比target要大的一个合法日期,格式(DD/MM/YYYY)
  • alpha - 只包含英文字符
  • alpha_dash - 可以包含英文、数字、下划线、破折号
  • alpha_num - 可以包含英文和数字
  • before:{target} - 和after相反
  • between:{min},{max} - 在min和max之间的数字
  • confirmed:{target} - 必须和target一样
  • date_between:{min,max} - 日期在min和max之间
  • date_format:{format} - 合法的format格式化日期
  • decimal:{decimals?} - 数字,而且是decimals进制
  • digits:{length} - 长度为length的数字
  • dimensions:{width},{height} - 符合宽高规定的图片
  • email - 不解释
  • ext:[extensions] - 后缀名
  • image - 图片
  • in:[list] - 包含在数组list内的值
  • ip - ipv4地址
  • max:{length} - 最大长度为length的字符
  • mimes:[list] - 文件类型
  • min - max相反
  • mot_in - in相反
  • numeric - 只允许数字
  • regex:{pattern} - 值必须符合正则pattern
  • required - 不解释
  • size:{kb} - 文件大小不超过
  • url:{domain?} - (指定域名的)url
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!