前端框架Vue(8)——Vue + 表单验证 VeeValidate 实践

  这次来讲一下表单验证插件 VeeValidate,那为什么要结合 Vue 来讲呢?来看一下 github 上的图片就明白了!

前端框架Vue(8)——Vue + 表单验证 VeeValidate 实践

  为 Vue 而来的!不清楚是不是 Vue 的官方表单验证插件。

  废话不多说直接显示效果:

前端框架Vue(8)——Vue + 表单验证 VeeValidate 实践

===============================分隔线==================================

  为什么需要用表单验证插件,想想自己重写过几次表单验证,重复造轮子相当的痛苦,当然你可以自己造一套通用的组件。我比较懒,表单验证就用现成的,VeeValidate 可扩展性也不错,所以就使用它来做表单验证。

  jquery.validate 也是不错的选择,这是后话了,本文就只介绍 VeeValidate 在 Vue 中的实践。

1、安装

  支持3中方式的引入项目

npm

npm install vee-validate --save

bower

bower install vee-validate#2.0.0-rc.4 --save

CDN

https://cdn.jsdelivr.net/vee-validate/2.0.0-rc.3/vee-validate.min.js

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 支持你去扩展,完成各种不同的需求。你可以参照着官网文档,造一个自己的表单验证,这样不同项目时只需要进行简单的修改就能用上了。


  VeeValidate 具备丰富的文档:

    官网地址传送门

    优秀文章:
        1、vee-validate 表单验证
        2、Vue2.0表单校验组件vee-validate的使用

相关推荐