vee-validate使用教程
目前創(chuàng)新互聯(lián)建站已為千余家的企業(yè)提供了網(wǎng)站建設(shè)、域名、網(wǎng)絡(luò)空間、網(wǎng)站運(yùn)營、企業(yè)網(wǎng)站設(shè)計、紅山網(wǎng)站維護(hù)等服務(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之后進(jìn)行校驗,messages代表自定義校驗信息,strict=true代表沒有設(shè)置規(guī)則的表單不進(jìn)行校驗,errorBagName屬于高級應(yīng)用,自定義errors,待研究
三、基礎(chǔ)使用
{{ errors.first('email') }}
提醒:錯誤信息里面的名稱通常就是表單的name屬性,除非是通過Vue實例傳遞進(jìn)來的。
提醒:養(yǎng)成好習(xí)慣,給每個field添加name
屬性,如果沒有name
屬性又沒有對值進(jìn)行綁定的話,validator可能不會對其進(jìn)行正確的校驗
關(guān)于errors:
上面的代碼我們看到有errors.has
,errors.first
,errors
是組件內(nèi)置的一個數(shù)據(jù)模型,用來存儲和處理錯誤信息,可以調(diào)用以下方法:
errors.first('field')
- 獲取關(guān)于當(dāng)前field的第一個錯誤信息collect('field')
- 獲取關(guān)于當(dāng)前field的所有錯誤信息(list)has('field')
- 當(dāng)前filed是否有錯誤(true/false)all()
- 當(dāng)前表單所有錯誤(list)any()
- 當(dāng)前表單是否有任何錯誤(true/false)add(String field, String msg)
- 添加錯誤clear()
- 清除錯誤count()
- 錯誤數(shù)量remove(String field)
- 清除指定filed的所有錯誤關(guān)于Validator
Validator是以$validator
被組件自動注入到Vue實例的。同時也可以獨立的進(jìn)行調(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ī)則
五、自定義校驗規(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位手機(jī)號碼', }, 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位手機(jī)號碼', }, validate: value => { return value.length == 11 && /^((13|14|15|17|18)[0-9]{1}\d{8})$/.test(value) } });
然后接可以直接把mobile當(dāng)成內(nèi)置規(guī)則使用了:
{{ errors.first('mobile') }}
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)。