VeeValidate是什麼:
VeeValidate是Vue.js的驗證庫,它有很多驗證規則,並支援自定義規則。它基於模板,因此它與HTML5驗證API相似並且很熟悉。您可以驗證HTML5輸入以及自定義Vue元件。它也是以本地化為基礎構建的,實際上我們有大約44種語言由精彩的社群成員支援和維護。
本文包含VeeValidate包含以下幾點應用:
- 1、基本安裝使用
- 2、本地化支援
- 3、自定義規則和錯誤訊息
- 4、驗證HTML5輸入和自定義Vue元件
- 5、統一提交按鈕處理
先看看頁面效果:
如果需要這個校驗案例原始碼的老鐵,移步我的github地址:VeeValidate校驗應用(歡迎★star),可以執行。下面步入主題:
基本安裝使用
VeeValidate的使用支援兩種方式: 一種是:NPM/yarn(npm install vee-validate --save), 一種是:CDN。
本文是以CDN的方式引用:
<script type="text/javascript" src="js/jquery-3.2.1.min.js" ></script>
<script type="text/javascript" src="js/vue.min.js" ></script>
<script type="text/javascript" src="js/vee-validate.min.js" ></script>
<script type="text/javascript" src="js/zh_CN.js" ></script>
複製程式碼
註釋:引入了四個js檔案,前面兩個略講,後面的兩個分別是vee-validata和zh_CN中文語言包檔案
html頁面部分:
<div class="enroll" id="recommend-box">
<div class="title">請填寫您要薦購的書籍資訊:</div>
<div class="content">
<div class="info infoa">
<div class="group-input">
<span class="a">書 名:</span>
<input v-model="title" v-validate="'required'" data-vv-as="書名" type="text" name="title" placeholder="請輸入推薦書名" />
</div>
<div class="errors" v-show="errors.has('title')" v-cloak>{{ errors.first('title') }}</div>
</div>
<div class="info infoa">
<div class="group-input">
<span class="a">作 者:</span>
<input v-model="author" v-validate="'required'" data-vv-as="作者" type="text" name="author" placeholder="請輸入作者" />
</div>
<div class="errors" v-show="errors.has('author')" v-cloak>{{ errors.first('author') }}</div>
</div>
<div class="info infoa">
<div class="group-input">
<span class="a">出版社:</span>
<input v-model="publisher" v-validate="'required'" data-vv-as="出版社" type="text" name="publisher" placeholder="請輸入出版社" />
</div>
<div class="errors" v-show="errors.has('publisher')" v-cloak>{{ errors.first('publisher') }}</div>
</div>
<div class="info infob">
<div class="group-input">
<span class="a">出版年:</span>
<input v-model="pubYear" v-validate="'required|pubYear|digits:4'" data-vv-as="出版年" type="text" name="pubYear" placeholder="請輸入出版年" />
</div>
<div class="errors" v-show="errors.has('pubYear')" v-cloak>{{ errors.first('pubYear') }}</div>
</div>
<div class="info infob">
<div class="group-input">
<span class="a">語言型別:</span>
<input v-model="type" v-validate="'required'" data-vv-as="語言型別" type="text" name="type" placeholder="語言型別" />
</div>
<div class="errors" v-show="errors.has('type')" v-cloak>{{ errors.first('type') }}</div>
</div>
<div class="info infob">
<div class="group-input">
<span class="a">ISBN號:</span>
<input v-model="isbn" v-validate="'required|isbn'" data-vv-as="ISBN號" type="text" name="isbn" placeholder="ISBN號" />
</div>
<div class="errors" v-show="errors.has('isbn')" v-cloak>{{ errors.first('isbn') }}</div>
</div>
<div class="info infob more">
<div class="group-input">
<span class="a">推薦理由:</span>
<textarea v-model="remark" v-validate="'max:200'" data-vv-as="推薦理由" type="text" name="remark" placeholder="請輸入推薦理由"></textarea>
</div>
<div class="errors" v-show="errors.has('remark')" v-cloak>{{ errors.first('remark') }}</div>
</div>
<div class="info info-btn">
<div class="btton" @click="validateBeforeSubmit()">提交</div>
</div>
</div>
</div>
複製程式碼
註釋:這邊包含以下幾個VeeValidate知識點:
1、input/textarea標籤中的v-validate、data-vv-as、name屬性。(v-model我這裡是雙向繫結,方便把這些引數傳遞給介面請求,不做過多介紹) 2、錯誤提示標籤裡面的v-show="errors.has('remark')" 和**{{ errors.first('remark') }}**
v-validate:
v-validate指令新增到您希望驗證的輸入中,並確保您的輸入具有name用於生成錯誤訊息的屬性。 然後,傳遞給指令一個rules字串,其中包含由管道' |' 分隔的驗證規則列表。比如上面的出版年份的校驗,使用required這個選項是必填項,pubYear以表明該欄位必須為年的格式(當然這裡是自定義的),digits:4,數字長度是4。要結合這兩個規則,我們指定字串值required|pubYear|digits:4的v-validate表示式的值。
data-vv-as:
當為這個輸入生成任何錯誤訊息時,它將使用該data-vv-as值而不是實際的欄位名稱,預設的錯誤提示都是英文,如果你設定了這個,錯誤提示欄位名稱它會提示data-vv-as值
v-show="errors.has('remark')
預設錯誤提示的標籤不載入出來
errors.first('remark')
獲取關於當前remark的第一個錯誤資訊
js部分:
<script type="text/javascript">
var IndexPage = "http://localhost:8080/xxxx.html"
var AuthCode = "12131";
$(function () {
recommend(AuthCode);
})
VeeValidate.Validator.localize('zh_CN');
Vue.use(VeeValidate);
VeeValidate.Validator.localize({
zh_CN: {
messages: {
required: function (name) { return name + '不能為空' },
}
}
})
VeeValidate.Validator.extend('isbn',{
getMessage: function () { return " 請輸入正確格式的isbn號" },
validate: function (value) { return /^[\d-]*$/.test(value);}
})
VeeValidate.Validator.extend('pubYear', {
getMessage: function () { return " 請輸入正確的年份" },
validate: function (value) { return /^(19|20)\d{2}$/.test(value); }
})
function recommend(AuthCode) {
var classList = new Vue({
el: '#recommend-box',
data: function () {
return {
title: "",
author: "",
publisher: "",
pubYear: "",
type: "",
remark: "",
isbn: ""
}
},
methods: {
validateBeforeSubmit() {
this.$validator.validateAll().then((result) => {
if (result) {
$.ajax({
url: '/xxxx',
data: {
Request: "xxxxx",
title: this.title,
author: this.author,
publisher: this.publisher,
pubYear: this.pubYear,
type: this.type,
remark: this.remark,
isbn: this.isbn,
certId: AuthCode
},
type: 'POST',
dataType: "json",
success: function (data) {
var msg = data.msg;
alert(msg);
window.location.href = IndexPage;
}
});
return;
}
alert("請輸入完整推薦資訊!")
});
}
}
})
}
</script>
複製程式碼
好,接下來我們一起來讀一下這個程式碼
VeeValidate.Validator.localize('zh_CN');
Vue.use(VeeValidate);
複製程式碼
####註釋:這以上程式碼的意思是 1、改變成zh_CN中午的語言環境,如果不改預設提示是英文 2、安裝VeeValidate外掛,也可以理解是初始化
VeeValidate.Validator.localize({
zh_CN: {
messages: {
required: function (name) { return name + '不能為空' },
}
}
})
複製程式碼
####註釋:上程式碼修改預設提示語,name屬性加不能為空,也就是必填項的非空判斷
VeeValidate.Validator.extend('isbn',{
getMessage: function () { return " 請輸入正確格式的isbn號" },
validate: function (value) { return /^[\d-]*$/.test(value);}
})
VeeValidate.Validator.extend('pubYear', {
getMessage: function () { return " 請輸入正確的年份" },
validate: function (value) { return /^(19|20)\d{2}$/.test(value); }
})
複製程式碼
####註釋:上程式碼修改自定義規則 getMessage : 提示語。 validate: 就是匹配規則,通常就正則咯。
validateBeforeSubmit() {
this.$validator.validateAll().then((result) => {
if (result) {
//這裡寫具體的介面請求
alert("推薦成功!")
return;
}
alert("請輸入完整推薦資訊!")
}
}
複製程式碼
####註釋:上程式碼建立一個提交按鈕事件,監聽是否正常填寫選項,實現校驗
一個完整的校驗應用案例到這裡已經講解的差不多了,小夥伴們可以根據自己的實際情況應用在自己的專案中, 如果需要校驗案例原始碼的老鐵,移步我的github地址:VeeValidate校驗應用(歡迎★star) 如果需要深入瞭解,可以移步到:VeeValidate官網