Vue2.0表單校驗組件vee-validate的使用詳解

vee-validate使用教程

目前創(chuàng)新互聯(lián)建站已為千余家的企業(yè)提供了網(wǎng)站建設(shè)、域名、網(wǎng)絡(luò)空間、網(wǎng)站運營、企業(yè)網(wǎng)站設(shè)計、紅山網(wǎng)站維護等服務(wù),公司將堅持客戶導(dǎo)向、應(yīng)用為本的策略,正道將秉承"和諧、參與、激情"的文化,與客戶和合作伙伴齊心協(xié)力一起成長,共同發(fā)展。

本文適合有一定Vue2.0基礎(chǔ)的同學(xué)參考,根據(jù)項目的實際情況來使用,關(guān)于Vue的使用不做多余解釋。本人也是一邊學(xué)習(xí)一邊使用,如果錯誤之處敬請批評指出*

一、安裝

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);

組件設(shè)置:

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還有更多應(yīng)用,下面再講。

config其它參數(shù),delay代表輸入多少ms之后進行校驗,messages代表自定義校驗信息,strict=true代表沒有設(shè)置規(guī)則的表單不進行校驗,errorBagName屬于高級應(yīng)用,自定義errors,待研究

三、基礎(chǔ)使用

<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實例傳遞進來的。

提醒:養(yǎng)成好習(xí)慣,給每個field添加name屬性,如果沒有name屬性又沒有對值進行綁定的話,validator可能不會對其進行正確的校驗

關(guān)于errors:

上面的代碼我們看到有errors.has,errors.first,errors是組件內(nèi)置的一個數(shù)據(jù)模型,用來存儲和處理錯誤信息,可以調(diào)用以下方法:

  1. errors.first('field') - 獲取關(guān)于當(dāng)前field的第一個錯誤信息
  2. collect('field') - 獲取關(guān)于當(dāng)前field的所有錯誤信息(list)
  3. has('field') - 當(dāng)前filed是否有錯誤(true/false)
  4. all() - 當(dāng)前表單所有錯誤(list)
  5. any() - 當(dāng)前表單是否有任何錯誤(true/false)
  6. add(String field, String msg) - 添加錯誤
  7. clear() - 清除錯誤
  8. count() - 錯誤數(shù)量
  9. remove(String field) - 清除指定filed的所有錯誤

關(guān)于Validator

Validator是以$validator被組件自動注入到Vue實例的。同時也可以獨立的進行調(diào)用,用來手動檢查表單是否合法,以傳入一個對象的方式,遍歷其中指定的field。

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

你也可以在構(gòu)造了validator之后設(shè)置對象參數(shù)

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

四、內(nèi)置的校驗規(guī)則

  1. after{target} - 比target要大的一個合法日期,格式(DD/MM/YYYY)
  2. alpha - 只包含英文字符
  3. alpha_dash - 可以包含英文、數(shù)字、下劃線、破折號
  4. alpha_num - 可以包含英文和數(shù)字
  5. before:{target} - 和after相反
  6. between:{min},{max} - 在min和max之間的數(shù)字
  7. confirmed:{target} - 必須和target一樣
  8. date_between:{min,max} - 日期在min和max之間
  9. date_format:{format} - 合法的format格式化日期
  10. decimal:{decimals?} - 數(shù)字,而且是decimals進制
  11. digits:{length} - 長度為length的數(shù)字
  12. dimensions:{width},{height} - 符合寬高規(guī)定的圖片
  13. email - 不解釋
  14. ext:[extensions] - 后綴名
  15. image - 圖片
  16. in:[list] - 包含在數(shù)組list內(nèi)的值
  17. ip - ipv4地址
  18. max:{length} - 最大長度為length的字符
  19. mimes:[list] - 文件類型
  20. min - max相反
  21. mot_in - in相反
  22. numeric - 只允許數(shù)字
  23. regex:{pattern} - 值必須符合正則pattern
  24. required - 不解釋
  25. size:{kb} - 文件大小不超過
  26. url:{domain?} - (指定域名的)url

五、自定義校驗規(guī)則

1.直接定義

const validator = (value, args) => {
  // Return a Boolean or a Promise.
}
//最基本的形式,只返回布爾值或者Promise,帶默認(rèn)的錯誤提示

2.對象形式

const validator = {
  getMessage(field, args) { // 添加到默認(rèn)的英文錯誤消息里面
    // 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.
  }
};

創(chuàng)建了規(guī)則之后,用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當(dāng)成內(nèi)置規(guī)則使用了:

<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.自定義內(nèi)置規(guī)則的錯誤信息

import { Validator } from 'vee-validate';

const dictionary = {
  en: {
    messages: {
      alpha: () => 'Some English Message'
    }
  },
  cn: {
    messages: {
      alpha: () => '對alpha規(guī)則的錯誤定義中文描述'
    }
  }
};

Validator.updateDictionary(dictionary);

暫時介紹到這里,應(yīng)該已經(jīng)上手了,有空再繼續(xù)翻譯。

其它問題或者更高級應(yīng)用,請參考官方文檔Vee-Validate

以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持創(chuàng)新互聯(lián)。

當(dāng)前文章:Vue2.0表單校驗組件vee-validate的使用詳解
網(wǎng)頁URL:http://muchs.cn/article42/pdjdhc.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供服務(wù)器托管、用戶體驗響應(yīng)式網(wǎng)站、商城網(wǎng)站、品牌網(wǎng)站制作、網(wǎng)站營銷

廣告

聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)

成都網(wǎng)頁設(shè)計公司