您好,登錄后才能下訂單哦!
vee-validate使用教程
本文適合有一定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)用以下方法:
errors.first('field')
- 獲取關(guān)于當前field的第一個錯誤信息collect('field')
- 獲取關(guān)于當前field的所有錯誤信息(list)has('field')
- 當前filed是否有錯誤(true/false)all()
- 當前表單所有錯誤(list)any()
- 當前表單是否有任何錯誤(true/false)add(String field, String msg)
- 添加錯誤clear()
- 清除錯誤count()
- 錯誤數(shù)量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ī)則
五、自定義校驗規(guī)則
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. } };
創(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當成內(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í)有所幫助,也希望大家多多支持億速云。
免責聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點不代表本網(wǎng)站立場,如果涉及侵權(quán)請聯(lián)系站長郵箱:is@yisu.com進行舉報,并提供相關(guān)證據(jù),一經(jīng)查實,將立刻刪除涉嫌侵權(quán)內(nèi)容。