jQuery.Validate驗證庫

一、用前必備
官方網站:http://bassistance.de/jquery-plugins/jquery-plugin-validation/
API: http://jquery.bassistance.de/api-browser/plugins.html
當前版本:1.5.5
需要JQuery版本:1.2.6+, 兼容 1.3.2
<script src="../js/jquery.js" type="text/javascript"></script>
<script src="../js/jquery.validate.js" type="text/javascript"></script>

二、默認校驗規則
(1)required:true 必輸字段
(2)remote:"check.php" 使用ajax方法調用check.php驗證輸入值
(3)email:true 必須輸入正確格式的電子郵件
(4)url:true 必須輸入正確格式的網址
(5)date:true 必須輸入正確格式的日期
(6)dateISO:true 必須輸入正確格式的日期(ISO),例如:2009-06-23,1998/01/22 只驗證格式,不驗證有效性
(7)number:true 必須輸入合法的數字(負數,小數)
(8)digits:true 必須輸入整數
(9)creditcard: 必須輸入合法的信用卡號
(10)equalTo:"#field" 輸入值必須和#field相同
(11)accept: 輸入擁有合法後綴名的字符串(上傳文件的後綴)
(12)maxlength:5 輸入長度最多是5的字符串(漢字算一個字符)
(13)minlength:10 輸入長度最小是10的字符串(漢字算一個字符)
(14)rangelength:[5,10] 輸入長度必須介於 5 和 10 之間的字符串")(漢字算一個字符)
(15)range:[5,10] 輸入值必須介於 5 和 10 之間
(16)max:5 輸入值不能大於5
(17)min:10 輸入值不能小於10

三、默認的提示

Js代碼
messages: { 
required: "This field is required.", 
remote: "Please fix this field.", 
email: "Please enter a valid email address.", 
url: "Please enter a valid URL.", 
date: "Please enter a valid date.", 
dateISO: "Please enter a valid date (ISO).", 
dateDE: "Bitte geben Sie ein g眉ltiges Datum ein.", 
number: "Please enter a valid number.", 
numberDE: "Bitte geben Sie eine Nummer ein.", 
digits: "Please enter only digits", 
creditcard: "Please enter a valid credit card number.", 
equalTo: "Please enter the same value again.", 
accept: "Please enter a value with a valid extension.", 
maxlength: $.validator.format("Please enter no more than {0} characters."), 
minlength: $.validator.format("Please enter at least {0} characters."), 
rangelength: $.validator.format("Please enter a value between {0} and {1} characters long."), 
range: $.validator.format("Please enter a value between {0} and {1}."), 
max: $.validator.format("Please enter a value less than or equal to {0}."), 
min: $.validator.format("Please enter a value greater than or equal to {0}.") 
}, 


如需要修改,可在js代碼中加入:

Js代碼
jQuery.extend(jQuery.validator.messages, { 
required: "必選字段", 
remote: "請修正該字段", 
email: "請輸入正確格式的電子郵件", 
url: "請輸入合法的網址", 
date: "請輸入合法的日期", 
dateISO: "請輸入合法的日期 (ISO).", 
number: "請輸入合法的數字", 
digits: "只能輸入整數", 
creditcard: "請輸入合法的信用卡號", 
equalTo: "請再次輸入相同的值", 
accept: "請輸入擁有合法後綴名的字符串", 
maxlength: jQuery.validator.format("請輸入一個長度最多是 {0} 的字符串"), 
minlength: jQuery.validator.format("請輸入一個長度最少是 {0} 的字符串"), 
rangelength: jQuery.validator.format("請輸入一個長度介於 {0} 和 {1} 之間的字符串"), 
range: jQuery.validator.format("請輸入一個介於 {0} 和 {1} 之間的值"), 
max: jQuery.validator.format("請輸入一個最大爲 {0} 的值"), 
min: jQuery.validator.format("請輸入一個最小爲 {0} 的值") 
}); 


推薦做法,將此文件放入messages_cn.js中,在頁面中引入

Js代碼
<script src="../js/messages_cn.js" type="text/javascript"></script> 


 

四、使用方式
1.將校驗規則寫到控件中

Js代碼
<script src="../js/jquery.js" type="text/javascript"></script> 
<script src="../js/jquery.validate.js" type="text/javascript"></script> 
<script src="./js/jquery.metadata.js" type="text/javascript"></script> 
$().ready(function() { 
$("#signupForm").validate(); 
}); 

<form id="signupForm" method="get" action=""> 
<p> 
<label for="firstname">Firstname</label> 
<input id="firstname" name="firstname" class="required" /> 
</p> 
<p> 
<label for="email">E-Mail</label> 
<input id="email" name="email" class="required email" /> 
</p> 
<p> 
<label for="password">Password</label> 
<input id="password" name="password" type="password" class="{required:true,minlength:5}" /> 
</p> 
<p> 
<label for="confirm_password">確認密碼</label> 
<input id="confirm_password" name="confirm_password" type="password" class="{required:true,minlength:5,equalTo:'#password'}" /> 
</p> 
<p> 
<input class="submit" type="submit" value="Submit"/> 
</p> 
</form> 

使用class="{}"的方式,必須引入包:jquery.metadata.js

可以使用如下的方法,修改提示內容:

Js代碼
class="{required:true,minlength:5,messages:{required:'請輸入內容'}}" 


 

在使用equalTo關鍵字時,後面的內容必須加上引號,如下代碼:
Js代碼
 
class="{required:true,minlength:5,equalTo:'#password'}" 

 
另外一個方式,使用關鍵字:meta(爲了元數據使用其他插件你要包裝 你的驗證規則 在他們自己的項目中可以用這個特殊的選項)

Tell the validation plugin to look inside a validate-property in metadata for validation rules.
例如:

Js代碼
 
meta: "validate" 
<input id="password" name="password" type="password" class="{validate:{required:true,minlength:5}}" /> 

再有一種方式:
Js代碼

 

$.metadata.setType("attr", "validate"); 


 

 

這樣可以使用validate="{required:true}"的方式,或者class="required",但class="{required:true,minlength:5}"將不起作用

2.將校驗規則寫到代碼中


Html代碼
$().ready(function() { 
$("#signupForm").validate({ 
rules: { 
firstname: "required", 
email: { 
required: true, 
email: true 
}, 
password: { 
required: true, 
minlength: 5 
}, 
confirm_password: { 
required: true, 
minlength: 5, 
equalTo: "#password" 
} 
}, 
messages: { 
firstname: "請輸入姓名", 
email: { 
required: "請輸入Email地址", 
email: "請輸入正確的email地址" 
}, 
password: { 
required: "請輸入密碼", 
minlength: jQuery.format("密碼不能小於{0}個字符") 
}, 
confirm_password: { 
required: "請輸入確認密碼", 
minlength: "確認密碼不能小於5個字符", 
equalTo: "兩次輸入密碼不一致不一致" 
} 
} 
}); 
}); 
//messages處,如果某個控件沒有message,將調用默認的信息 

<form id="signupForm" method="get" action=""> 
<p> 
<label for="firstname">Firstname</label> 
<input id="firstname" name="firstname" /> 
</p> 
<p> 
<label for="email">E-Mail</label> 
<input id="email" name="email" /> 
</p> 
<p> 
<label for="password">Password</label> 
<input id="password" name="password" type="password" /> 
</p> 
<p> 
<label for="confirm_password">確認密碼</label> 
<input id="confirm_password" name="confirm_password" type="password" /> 
</p> 
<p> 
<input class="submit" type="submit" value="Submit"/> 
</p> 
</form> 


 

required:true 必須有值
required:"#aa:checked"表達式的值爲真,則需要驗證
required:function(){}返回爲真,表時需要驗證
後邊兩種常用於,表單中需要同時填或不填的元素

五、常用方法及注意問題
1.用其他方式替代默認的SUBMIT

Js代碼
 
$().ready(function() { 
$("#signupForm").validate({ 
submitHandler:function(form){ 
alert("submitted"); 
form.submit(); 
} 
}); 
}); 


可以設置validate的默認值,寫法如下:

Js代碼
 
$.validator.setDefaults({ 
submitHandler: function(form) { alert("submitted!");form.submit(); } 
}); 


如果想提交表單, 需要使用form.submit()而不要使用$(form).submit()

2.debug,如果這個參數爲true,那麼表單不會提交,只進行檢查,調試時十分方便

Js代碼
 
$().ready(function() { 
$("#signupForm").validate({ 
debug:true 
}); 
}); 


如果一個頁面中有多個表單,用

Js代碼
 
$.validator.setDefaults({ 
debug: true 
}) 

3.ignore:忽略某些元素不驗證

Js代碼
 
ignore: ".ignore" 

4.errorPlacement:Callback Default: 把錯誤信息放在驗證的元素後面
指明錯誤放置的位置,默認情況是:error.appendTo(element.parent());即把錯誤信息放在驗證的元素後面
errorPlacement: function(error, element) {
error.appendTo(element.parent());
}
//示例:

Html代碼
 
<tr> 
<td class="label"><label id="lfirstname" for="firstname">First Name</label></td> 
<td class="field"><input id="firstname" name="firstname" type="text" value="" maxlength="100" /></td> 
<td class="status"></td> 
</tr> 
<tr> 
<td style="padding-right: 5px;"> 
<input id="dateformat_eu" name="dateformat" type="radio" value="0" /> 
<label id="ldateformat_eu" for="dateformat_eu">14/02/07</label> 
</td> 
<td style="padding-left: 5px;"> 
<input id="dateformat_am" name="dateformat" type="radio" value="1" /> 
<label id="ldateformat_am" for="dateformat_am">02/14/07</label> 
</td> 
<td></td> 
</tr> 
<tr> 
<td class="label"> </td> 
<td class="field" colspan="2"> 
<div id="termswrap"> 
<input id="terms" type="checkbox" name="terms" /> 
<label id="lterms" for="terms">I have read and accept the Terms of Use.</label> 
</div> 
</td> 
</tr> 

Js代碼
 
errorPlacement: function(error, element) { 
if ( element.is(":radio") ) 
error.appendTo( element.parent().next().next() ); 
else if ( element.is(":checkbox") ) 
error.appendTo ( element.next() ); 
else 
error.appendTo( element.parent().next() ); 
} 

代碼的作用是:一般情況下把錯誤信息顯示在<td class="status"></td>中,如果是radio顯示在<td></td>中,如果是checkbox顯示在內容的後面

errorClass:String Default: "error"
指定錯誤提示的css類名,可以自定義錯誤提示的樣式
errorElement:String Default: "label"
用什麼標籤標記錯誤,默認的是label你可以改成em
errorContainer:Selector
顯示或者隱藏驗證信息,可以自動實現有錯誤信息出現時把容器屬性變爲顯示,無錯誤時隱藏,用處不大
errorContainer: "#messageBox1, #messageBox2"
errorLabelContainer:Selector
把錯誤信息統一放在一個容器裏面。
wrapper:String
用什麼標籤再把上邊的errorELement包起來
一般這三個屬性同時使用,實現在一個容器內顯示所有錯誤提示的功能,並且沒有信息時自動隱藏

Js代碼
errorContainer: "div.error", 
errorLabelContainer: $("#signupForm div.error"), 
wrapper: "li" 



設置錯誤提示的樣式,可以增加圖標顯示

Js代碼
input.error { border: 1px solid red; } 
label.error { 
background:url("./demo/images/unchecked.gif") no-repeat 0px 0px; 
padding-left: 16px; 
padding-bottom: 2px; 
font-weight: bold; 
color: #EA5200; 
} 
label.checked { 
background:url("./demo/images/checked.gif") no-repeat 0px 0px; 
} 
success:String,Callback 


要驗證的元素通過驗證後的動作,如果跟一個字符串,會當做一個css類,也可跟一個函數

Js代碼
 
success: function(label) { 
// set   as text for IE 
label.html(" ").addClass("checked"); 
//label.addClass("valid").text("Ok!") 
} 




添加"valid" 到驗證元素, 在CSS中定義的樣式<style>label.valid {}</style>
success: "valid"

nsubmit: Boolean Default: true
提交時驗證. 設置唯false就用其他方法去驗證
onfocusout:Boolean Default: true
失去焦點是驗證(不包括checkboxes/radio buttons)
onkeyup:Boolean Default: true
在keyup時驗證.
onclick:Boolean Default: true
在checkboxes 和 radio 點擊時驗證
focusInvalid:Boolean Default: true
提交表單後,未通過驗證的表單(第一個或提交之前獲得焦點的未通過驗證的表單)會獲得焦點
focusCleanup:Boolean Default: false
如果是true那麼當未通過驗證的元素獲得焦點時,移除錯誤提示。避免和 focusInvalid 一起用

// 重置表單

Java代碼
$().ready(function() { 
var validator = $("#signupForm").validate({ 
submitHandler:function(form){ 
alert("submitted"); 
form.submit(); 
} 
}); 
$("#reset").click(function() { 
validator.resetForm(); 
}); 
}); 

remote:URL

使用ajax方式進行驗證,默認會提交當前驗證的值到遠程地址,如果需要提交其他的值,可以使用data選項

Js代碼
remote: "check-email.php" 
remote: { 
url: "check-email.php", //後臺處理程序 
type: "post", //數據發送方式 
dataType: "json", //接受數據格式 
data: { //要傳遞的數據 
username: function() { 
return $("#username").val(); 
} 
} 
} 

遠程地址只能輸出 "true" 或 "false",不能有其它輸出


addMethod:name, method, message
自定義驗證方法


Js代碼
// 中文字兩個字節 
jQuery.validator.addMethod("byteRangeLength", function(value, element, param) { 
var length = value.length; 
for(var i = 0; i < value.length; i++){ 
if(value.charCodeAt(i) > 127){ 
length++; 
} 
} 
return this.optional(element) || ( length >= param[0] && length <= param[1] ); 
}, $.validator.format("請確保輸入的值在{0}-{1}個字節之間(一箇中文字算2個字節)")); 

// 郵政編碼驗證 
jQuery.validator.addMethod("isZipCode", function(value, element) { 
var tel = /^[0-9]{6}$/; 
return this.optional(element) || (tel.test(value)); 
}, "請正確填寫您的郵政編碼"); 

radio和checkbox、select的驗證
radio的required表示必須選中一個

Html代碼
<input type="radio" id="gender_male" value="m" name="gender" class="{required:true}" /> 
<input type="radio" id="gender_female" value="f" name="gender"/> 
checkbox的required表示必須選中 
<input type="checkbox" class="checkbox" id="agree" name="agree" class="{required:true}" /> 
checkbox的minlength表示必須選中的最小個數,maxlength表示最大的選中個數,rangelength:[2,3]表示選中個數區間 
<input type="checkbox" class="checkbox" id="spam_email" value="email" name="spam[]" class="{required:true, minlength:2}" /> 
<input type="checkbox" class="checkbox" id="spam_phone" value="phone" name="spam[]" /> 
<input type="checkbox" class="checkbox" id="spam_mail" value="mail" name="spam[]" /> 

select的required表示選中的value不能爲空 
<select id="jungle" name="jungle" title="Please select something!" class="{required:true}"> 
<option value=""></option> 
<option value="1">Buga</option> 
<option value="2">Baga</option> 
<option value="3">Oi</option> 
</select> 
select的minlength表示選中的最小個數(可多選的select),maxlength表示最大的選中個數,rangelength:[2,3]表示選中個數區間 
<select id="fruit" name="fruit" title="Please select at least two fruits" class="{required:true, minlength:2}" multiple="multiple"> 
<option value="b">Banana</option> 
<option value="a">Apple</option> 
<option value="p">Peach</option> 
<option value="t">Turtle</option> 
</select> 


 

//////////////////////////////////////////////////////////////////////////////////////////////

jQuery.Validate是監控form,在任何提交表單的操作前jQuery.Validate都會檢測表單裏的輸入項是否滿足規則,滿足才允許提交。所以需

要在jQuery(document).ready()時爲form進行驗證註冊

具體代碼如下:

複製代碼
<body> <form id="form1" runat="server"> <div> <asp:ContentPlaceHolder ID="ContentPlaceHolder1" runat="server"> </asp:ContentPlaceHolder> </div> </form> <script type="text/javascript"> jQuery(document).ready(function() { jQuery("#form1").validate(); }); </script> </body>
複製代碼

jQuery.Validate爲我們提供了3種驗證編寫方式,各有優缺點:

1、在input對象中書寫class樣式指定驗證規則或屬性驗證規則:

如<input type=”text” class=”required”/>

最簡單、最便捷,提示消息使用jQuery.Validate的內置的消息(自定義擴展驗證規則也屬於此項),但是由於是以樣式名的方式進行驗證,導致了日後修改必須找到相應的input對象,同時無法使用高級驗證規則,具體說明請向下看

2、同第1條,這種驗證規則方式也是在input對象中書寫class樣式,只不過書寫的方式改爲了JSON格式,但是這種方式提供了自定義驗證消息的支持:

如<input type=”text” class="{required:true,minlength:5,,messages:{required:'請輸入內容'}”/>

簡單、方便,但個人認爲有點臃腫,還是和第1條一樣和相對應的input對象糾纏在一起,並且還增加消息自定義,使得input對象變的更大了,干擾了頁面代碼的閱讀,但可以使用高級驗證規則(實際就是將第3種JS以JSON的格式放到具體的class中

3、這種方式使用純JS的方式:

如:

$().ready(function() { 
$("#aspnetform").validate({ 
rules: { 
name: "required", 
email: { 
required: true, 
email: true 
}

})

})


 

很好的解決了HTML和驗證規則的分離,就是書寫較爲麻煩,需要單獨寫JS腳本,但好處是可以統一驗證規範,將每個頁面的驗證規則都寫在頭部的腳本中,方便日後維護。

注意:以上3種驗證方式的消息如果未指定都會默認調用內置的消息

1、在使用上一篇中第2種方式,以JSON的格式編寫驗證規則,影響了正常的class使用,如何處理?

2、在ASP.NET下,所有的按鈕都會提交form表單,所以都會引發驗證,如何處理?

3、我希望驗證的提示信息可以在統一的地方顯示,如何處理?

4、我在開發的過程中,我不確定所編寫的規則是否正確,如何進行調試?

5、我使用的是微軟AJAX控件,想監控dropdownlist是否選擇,爲何不起作用?

6、radiobox,checkbox,listbox如何進行高級應用?如何指定選擇數量?

1點:在使用上一篇中第2種方式,以JSON的格式編寫驗證規則,影響了正常的class使用,如何處理?具體見Middle-4.aspx

首先看下使用第2種方式是如何編寫驗證規則的:

<asp:TextBox ID="txtPwd" TextMode="Password" runat="server" CssClass="{required:true,minlength:6,messages:{required:'你不輸入密碼怎麼行呢?',minlength:'密碼太短啦至少6位'}}"></asp:TextBox>

可以看到這樣寫驗證規則雖然簡單,但是如果我要爲這個控件應用其他樣式怎麼辦?所以現在就是處理這個問題的時候了,在頁面的頭部加上一句代碼:

jQuery.metadata.setType("attr", "validate");


由於這種驗證規則方式需要依賴jQuery.metadata纔可以正常運作,所以我們需要在jQuery.metadata上做文章,分析下jQuery.metadata的代碼,可以看到,默認情況下它是檢測控件的class屬性:

defaults : { 
type: 'class', 
name: 'metadata', 
cre: /({.*})/, 
single: 'metadata' 
}


那我們可不可以更改這個屬性呢?肯定是可以的,就是在頁面上加上那句代碼,更改其檢測的屬性。

接着我們還需要修改下頁面中的代碼,將原來所有的"CssClass”改爲我們更改的檢測屬性"validate”、

這樣就很好的更改了驗證規則所存放的屬性了。

第2點:在ASP.NET下,所有的按鈕都會提交form表單,所以都會引發驗證,如何處理?(具體見Middle-4.aspx中btnNoValidate按鈕

在實際的開發當中,一個頁面上總會有N個按鈕,由於ASP.NET的機制特性,所有的控件都會回發頁面,也就提交了表單,但是此時整個表單都被jQuery.Validate所監控,所以只要頁面中有某個地方不符合驗證規則,任何回發頁面的操作都會被攔截住,但是實際上我們需要引發驗證的按鈕只有1或者2個,而其他按鈕不需要,這時我們就要想辦法了。

其實很簡單,就是爲不需要引發驗證的控件加個樣式"cancel"即可,代碼如下:

<asp:Button ID="btnNoValidate" runat="server" Text="點我不會引發驗證哦" CssClass="cancel" />


怎麼樣很簡單吧?

第3點:我希望驗證的提示信息可以在統一的地方顯示,如何處理?(具體見Middle-5.aspx

在開發的過程當中,會有一些特殊的需求,就比如頁面上使用了tab頁面,而提交按鈕就一個,這時就需要將驗證提示信息統一放在一個位置,好方便查看,如圖:

pic21

要實現這個效果只需在JS編寫驗證規則時添加:

<asp:Button ID="btnNoValidate" runat="server" Text="點我不會引發驗證哦" CssClass="cancel" />


error是一個label對象裏面包含了錯誤消息,element則是驗證未通過的對象元素,通過errorPlacement可以方便的將驗證提示信息統一放入一個位置。

第4點:我在開發的過程中,我不確定所編寫的規則是否正確,如何進行調試?(具體見Middle-5.aspx

這個就比較簡單了,jQuery.Validate默認已經爲我們考慮過了,只需在JS編寫規則時添加一個屬性:

debug:true

這樣就表示現在在調試,這時不會提交表單。

第5點:我使用的是微軟AJAX控件,想監控dropdownlist是否選擇,爲何不起作用?(具體見Middle-5.aspx中的性別

在使用微軟AJAX控件中的dropdownlist級聯時,比如省市區聯動,如果省沒有選擇,則市和區都是灰的,是disabled狀態,是被禁用的,類似代碼如下:

<asp:DropDownList ID="DropDownList1" runat="server" CssClass="required" disabled="true"> 
<asp:ListItem></asp:ListItem> 
<asp:ListItem Value="1">男</asp:ListItem> 
<asp:ListItem Value="0">女</asp:ListItem> 
</asp:DropDownList>


我這邊是強制把這個DropDownList禁用了,這時如果爲這個控件加上“required”將不會有任何反應,因爲在jQuery.Validate代碼中默認是不驗證的,具體代碼見jQuery.Validate.js414行:

not(":submit, :reset, :image, [disabled]")

所以爲了方便我們使用,我們修改下代碼,將[disabled]"去除,改爲:

not(":submit, :reset, :image")

這樣再刷新下頁面,驗證就起作用了。

第6點:radiobox,checkbox,listbox如何進行高級應用?如何指定選擇數量?(具體請見radio-checkbox-select-demo.html

這點我直接引用了官方關於radiobox,checkbox,listbox應用的例子,因爲官方的例子已經寫的非常好了。

1、擴展驗證規則,jQuery.Validate只提供了一些基本的驗證功能,並不能滿足我們日常開發的需求,所以我們要爲jQuery.Validate擴展驗證規則。

2、分組驗證,在開發的時候有時會遇到的一個問題就是,不同按鈕引發不同的驗證。

首先來介紹下第一點:擴展驗證規則,在jQuery.Validate默認的驗證規則無法滿足我們的日常開發需求的時候,我們需要根據自己的業務需求指定一些相應的規則。(具體見MasterPage.master)

爲了擴展驗證規則,我們首先要看下jQuery.Validate爲我們提供的擴展方法:

addMethod: function(name, method, message) { 
$.validator.methods[name] = method; 
$.validator.messages[name] = message; 
if (method.length < 3) { 
$.validator.addClassRules(name, $.validator.normalizeRule(name)); 
} 
},


這段代碼就是用來擴展驗證規則的,意思很簡單,就是向jQuery.Validate添加驗證方法。

接收3個參數:name-驗證規則名

method-驗證規則實現函數(function)

message-驗證不通過顯示的錯誤消息

當我們調用了這個方法後,我們所寫的規則自動就會加入到jQuery.Validate規則中。

好了,我們看下具體如何實現:

手機號碼驗證:

jQuery.validator.addMethod("telphoneValid", function(value, element) { 
var tel = /^(130|131|132|133|134|135|136|137|138|139|150|153|157|158|159|180|187|188|189)\d{8}$/; 
return tel.test(value) || this.optional(element); 
}, "請輸入正確的手機號碼");

這邊的method需要注意的是,這個method實現函數接收2個元素:

value:檢測的對象的值

element:檢測的對象


 

這邊我定義了一個名爲“telphoneValid”的驗證規則,在驗證規則裏我首先定義了個手機驗證的正則表達式,然後將值放入正則表達式進行驗證,返回驗證結果,返回的錯誤消息是“請輸入正確的手機號碼”。

這樣就完成了一個簡單的手機號碼驗證規則擴展。

第2點:分組驗證,這個分組驗證在默認的jQuery.Validate中默認是不支持的,也是我覺得很不爽的,因爲在實際的開發過程中經常會碰到需要分組驗證的時候。

這點微軟的驗證控件就做的很好,在微軟的控件裏,默認都有ValidationGroup這個屬性,只要把屬性名設置爲相同就可以進行分組驗證了,但是jQuery.Validate自身卻沒提供這個功能,所以我們只能自己擴展了。

來一下具體的場景,在一個頁面裏有2個tab頁面,不同tab頁面需要不同的提交按鈕:

pic22

pic23

這2個就是標準的分組驗證情況,如果不設置分組驗證的情況下,點擊[基本信息提交]和[描述提交]按鈕後頁面上所有的驗證都會被相應,這是因爲2個按鈕都在一個form表單中,2個按鈕的點擊事件默認都是在客戶端提交表單,然後由服務器端來分配執行代碼,所以問題就出現了。

這時我們就需要引入分組驗證了,這個解決思路是我在一個國外的網站找到的,不過具體地址我找不到了,這個方法有個弊端就是必須是將需要分組的控件必須放入不同的容器中,如div,table等,因爲採用的是標識class樣式來進行分組驗證。

看下具體代碼:

//初始化分組驗證
function InitValidationGroup() {
$('.validationGroup .causesValidation').click(Validate);
$('.validationGroup :text').keydown(function(evt) {
if (evt.keyCode == 13) {
var $nextInput = $(this).nextAll(':input:first');
if ($nextInput.is(':submit')) {
Validate(evt);
}
else {
evt.preventDefault();
$nextInput.focus();
}
}
});
}
function Validate(evt) {
var $group = $(this).parents('.validationGroup');
var isValid = true;
$group.find(':input').each(function(i, item) {
if (!$(item).valid())
isValid = false;
});
if (!isValid)
evt.preventDefault();
}


上面的代碼就是用來進行分組驗證的初始化的,這段代碼會找尋頁面中標有validationGroup樣式的元素(分組的容器),然後在這個元素中找帶causesValidation樣式的元素(這個元素是引發驗證的按鈕),

上面代碼實現分組驗證的邏輯就是當帶causesValidation樣式的元素引發驗證後會找尋這個元素的父級validationGroup元素,然後遍歷validationGroup元素下的所有有驗證規則的元素判斷是否驗證通過。

頁面代碼:

<div id="tabs">
<ul>
<li><a href="#baseinfo">基本信息</a></li>
<li><a href="#personaldesc">個人描述</a></li>
</ul>
<div id="baseinfo" class="validationGroup">
<table cellpadding="1" cellspacing="1" border="1" width="50%" align="center">
<tr>
<td>
用戶名
</td>
<td>
<asp:TextBox ID="txtUid" runat="server"></asp:TextBox>
</td>
</tr>
<tr>
<td>
密碼
</td>
<td>
<asp:TextBox ID="txtPwd" ValidationGroup="" TextMode="Password" runat="server"></asp:Text
</td>
</tr>
<tr>
<td>
確認密碼
</td>
<td>
<asp:TextBox ID="txtRePwd" TextMode="Password" runat="server"></asp:TextBox>
</td>
</tr>
<tr>
<td>
姓名
</td>
<td>
<asp:TextBox ID="txtName" runat="server"></asp:TextBox>
</td>
</tr>
<tr>
<td>
年齡
</td>
<td>
<asp:TextBox ID="txtAge" runat="server"></asp:TextBox>
</td>
</tr>
<tr>
<td>
性別
</td>
<td>
<asp:DropDownList ID="DropDownList1" runat="server" CssClass="required" disabled="true">
<asp:ListItem></asp:ListItem>
<asp:ListItem Value="1">男</asp:ListItem>
<asp:ListItem Value="0">女</asp:ListItem>
</asp:DropDownList>
</td>
</tr>
<tr>
<td>
郵箱
</td>
<td>
<asp:TextBox ID="txtEmail" runat="server"></asp:TextBox>
</td>
</tr>
<tr>
<td colspan="2">
<asp:Button ID="Button3" runat="server" Text="基本信息提交" CssClass="causesValidation"/>
</td>
</tr>
</table>
</div>
<div id="personaldesc" class="validationGroup">
<p>
<asp:TextBox ID="txtDescription" runat="server" TextMode="MultiLine" Width="500px"
Height="100px"></asp:TextBox>
</p>
<asp:Button ID="Button1" runat="server" Text="描述提交" CssClass="causesValidation"/>
</div>
</div>
<script type="text/javascript">
InitRules();
isValidationGroup = true;
</script>


分析下代碼爲2個tab頁面都加上validationGroup樣式,引發驗證的按鈕加上causesValidation樣式,同時還需要標記一個isValidationGroup = true; 表示頁面需要進行分組驗證,傳遞迴母版頁。

注意:這邊的邏輯和手寫JS驗證規則是一個邏輯,在母版頁建立一個isValidationGroup屬性默認爲false,只有當頁面需要進行分組驗證則設爲true。

接下來看下母版頁的的jQuery(document).ready()中的帶代碼:

if (isValidationGroup) {
if (opts != undefined || opts != null) {
jQuery("#<%=form1.ClientId %>").validate(jQuery.extend(opts, { onsubmit: false }));
} else {
jQuery("#<%=form1.ClientId %>").validate({
onsubmit: false
});
}
InitValidationGroup();
} else {
if (opts != undefined || opts != null) {
jQuery("#<%=form1.ClientId %>").validate(opts);
} else {
jQuery("#<%=form1.ClientId %>").validate();
}
}


判斷isValidationGroup是否需要進行分組驗證,同時如果isValidationGroup爲true,需要加入onsubmit:false,否則分組驗證將無法有效。

1、如何使用jQuery.Validate進行AJAX驗證?

2、默認jQuery.Validate在進行AJAX驗證時返回必須是bool類型,如何返回一個對象包括錯誤消息及驗證結果?

3、在反覆使用jQuery.Validate進行AJAX驗證時,總是需要編寫相關AJAX參數,可否進行進一步封裝?

第一點:如何使用jQuery.Validate進行AJAX驗證?(具體見High-2.aspx

jQuery.Validate爲我們提供了一個方便的AJAX驗證方式(封裝了jQuery的AJAX,同時將jQuery的AJAX和jQuery.Validate的驗證很好的結合在一起),在此我僅僅介紹jQuery.Validate在ASP.NET下如何進行AJAX驗證,PHP、JSP等請查看官方例子。

我是採用jQuery.Validate+WebService進行AJAX驗證,客戶端編寫jQuery.Validate的remote驗證屬性,服務器端採用WebSerice進行接收參數進行驗證。

首先來看下jQuery.Validate的remote屬性如何編寫AJAX驗證規則:

function InitRules() {
opts = {
rules:
{
<%=txtUid.UniqueID %>: 
{
required: true,
remote:{
type: "POST",
async: false,
url: "WebService.asmx/CheckUid",
dataType: "xml",
data: {uid:function(){ return jQuery("#<%=txtUid.ClientID %>").val();}}
}
}
}
}
}

如果使用過jQuery.ajax的朋友肯定會很熟悉這段代碼,jQuery.Validate的remote採用和jQuery.ajax相同的參數設置(原因就上面所說的封裝了jQuery.ajax的原因)。

這邊來詳細講解下jQuery.Validate的remote的一些知識:

1、jQuery.Validate的remote默認可以直接填寫遠程驗證的地址,格式爲:remote:”validate.aspx”,但是很多情況下這個遠程驗證需要提交參數、返回類型等限制,所以就可以採用在“{}”中編寫具體屬性的方式來包裝提交參數。

2、jQuery.Validate的remote官方代碼中,遠程的輸出只能是true或者false,不允許有其他輸出,這個我覺得不太好,具體的擴展在後面我會講到

3、jQuery.Validate的remote在使用時如果想提交參數需要以JSON的方式提交格式如下:

data: {
uid:function(){ 
return jQuery("#<%=txtUid.ClientID %>").val();
}
}


此處肯定會有人不明白,爲什麼參數需要以function的形式提交,而不是直接寫

jQuery("#<%=txtUid.ClientID %>").val();

這裏我要說明的是:jQuery.Validate的驗證規則是在頁面加載的時候就已經被加載了的,如果還是像以往一樣直接寫"jQuery("#<%=txtUid.ClientID %>").val();",那麼驗證的時候提交給服務器端的數據永遠是頁面加載時txtUid控件的值。

而使用function的好處就是在頁面加載的時候僅僅告訴jQuery.Validate,在控件需要進行remote驗證的時候需要調用function這個函數,這樣就保證了在執行remote驗證的時候可以獲取到最新的值

我還修改了jQuery.Validate的remote方法,先來看下我修改的代碼(具體見scripts/jquery.validate1.js 896行):

if (previous.old !== value) {
previous.old = value;
var validator = this;
this.startRequest(element);
var data = {};
data[element.name] = value;
$.ajax($.extend(true, {
//url:url,//此URL無法獲取
url: param.url,//獲取param驗證規則中所寫路徑
mode: "abort",
port: "validate" + element.name,
type: param.type,
dataType: "json",
//data:data,
data: param.data || data,//獲取param.data或data中所提交的參數
success: function(response) {
以下省略...
}


這邊我修改了url和data的獲取方式,主要是因爲在真正執行的時候,變量url是空的,所以需要從param中獲取。

而data爲什麼要改成param.data || data,主要原因就是下面這句代碼:

data[element.name] = value;

這句代碼的意思就是:爲哪個控件設置遠程驗證就獲取哪個控件的值,但是在實際的開發中,當遇到進行AJAX驗證的時候會出現需要同時提交多個數據的情況,此時這句代碼就是錯誤的了,所以需要改成

param.data || data,這樣就能保證在提交多個數據的時候以多個數據爲準。

下面來看下webservice的代碼:

public bool CheckUid(string uid)
{
return uid == "testuid" ? true : false;
}


相當的簡單,就是判斷下用戶名是不是指定的用戶名。

注意:webservice.cs中必須將[System.Web.Script.Services.ScriptService]這個特性取消註釋,否則AJAX驗證將無效!

第二點:默認jQuery.Validate在進行AJAX驗證時返回必須是bool類型,如何返回一個對象包括錯誤消息及驗證結果?(具體見App_Code/WebService.cs/CheckUid

在第一點中介紹jQuery.Validate知識的時候就提到了,jQuery.Validate默認直接收true或false,但是在具體的開發中,我們會分層開發,三層或者多層,webservice在接收到驗證請求後不做具體的處理直接調用邏輯層的驗證方法,交由邏輯層進行驗證操作(當然你也可以把驗證全部寫在webservice中,但是這樣就體現不出分層的好處了),此時的驗證會產生多種情況,以最常見的用戶名驗證爲例:

1)用戶名已存在,此時的消息應該是“用戶名已存在,請重新輸入!”

2)用戶名不符合規則,此時的消息應該是“用戶名不符合規則,請重新輸入!”

3)驗證時出現程序異常,此時的消息應該是“程序出現異常,請聯繫管理員!”

可以看出,僅僅一個用戶名驗證就會出現這3種信息,如果不返回一個明確的消息,僅僅告訴用戶“用戶名有誤”,客戶端的使用者將會相當的痛苦,因爲使用者並不知道他的用戶名輸入到底錯在哪了。

所以爲了更好的客戶體驗,以及項目的合理性,我們在服務器端封裝一個實體類(具體見AppCode/AjaxClass),代碼如下:

public class AjaxClass
{
public string Msg { get; set; }
public int Result { get; set; }
}


就是一個最簡單的實體類,有2個屬性,Msg和Result,Msg用於存放驗證失敗的信息,Result用於存放結果。

看下WebSerivce的代碼如何修改:

public AjaxClass CheckUid(string uid)
{
//return uid == "testuid" ? true : false;
AjaxClass ajaxClass = new AjaxClass();
try
{
if (uid == "testuid")
{
ajaxClass.Msg = "用戶名已存在,請重新輸入!";
ajaxClass.Result = 0;
}
else if (uid.IndexOf("test") == -1)
{
ajaxClass.Msg = "用戶名格式不正確,用戶名必須包含test,請重新輸入!";
ajaxClass.Result = 0;
}
else
{
ajaxClass.Msg = "格式正確!";
ajaxClass.Result = 1;
}
}
catch
{
ajaxClass.Msg = "程序出現異常,請聯繫管理員!";
ajaxClass.Result = 0;
}
return ajaxClass;
}


上面的WebService就完整的實現了我先前說的3種錯誤情況(由於這邊僅僅是例子所以就只有表示層,實際開發中需要分層開發,此代碼應該放入業務邏輯層

注意:在webservice返回值前,如果檢查成功必須要爲ajaxClass.Result = 1,否則客戶端驗證會無法通過。

雖然完成了服務器端的代碼修改,但是直接運行頁面還是會出錯,這是因爲我上面所說過的,jQuery.Validate的remote遠程的輸出只能是true或者false,我們來看下具體的代碼,其中註釋掉的就是原來官方的代碼:

success: function(response) {
if (response.Result) {//if(response){
var submitted = validator.formSubmitted;
validator.prepareElement(element);
validator.formSubmitted = submitted;
validator.successList.push(element);
validator.showErrors();
} else {
var errors = {};
//errors[element.name] = response.Result || validator.defaultMessage(element, "remote");
errors[element.name] = response.Msg;
validator.showErrors(errors);
}
previous.message = response.Msg; //previous.valid = response;
previous.valid = response.Result;
validator.stopRequest(element, response.Result);
}


可以看到一共修改了3處地方:

1、判斷返回值,原來是直接判斷response,現在則是判斷response.Result,因爲現在的response已經是一個包含消息及結果的對象了。

2、錯誤消息,原來的錯誤消息是直接獲取默認配置好的消息,我這邊是獲取response.Msg。

3、設置previous對象,將previous對象的消息和結果設置爲AJAX返回的消息和結果,以供jQuery.Validate下面代碼的返回。

這樣jQuery.Validate的remote的方法就修改了,但是並沒有結束,原因是先前在AJAX提交參數的時候由於jQuery.Validate的驗證規則的緣故,提交的參數並不是以JSON的格式提交的而是以{uid:function()}這樣的方式,結果就導致了無法設置jQuery.AJAX的contentType:"application/json; charset=utf-8",如果設置了會出現以下錯誤:

pic24這樣從webservice返回的AjaxClass對象就無法像以往的JSON方式直接操作了,所以我們只能換一種格式——XML,因爲webservice默認返回的數據是XML格式:

<?xml version="1.0" encoding="utf-8" ?> 
- <AjaxClass xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://tempuri.org/">
<Msg>用戶名格式不正確,用戶名必須包含test,請重新輸入!</Msg> 
<Result>0</Result> 
</AjaxClass>


接下來看下具體的remote方法應該如何編寫,設置dataType:”xml”,然後將XML數據轉換成一個對象以供上面我修改的jQuery.Validate的remote方法中ajaxsuccess的使用,具體看一下代碼:

remote:{
type: "POST",
dataType:"json",
async: false,
url: "WebService.asmx/CheckUid",
data: {uid:function(){ return jQuery("#<%=txtUid.ClientID %>").val();}},
dataFilter: function(dataXML) {
var result = new Object();
result.Result = jQuery(dataXML).find("Result").text();
result.Msg = jQuery(dataXML).find("Msg").text();
if (result.Result == "-1") {
result.Result = false;
return result;
}
else {
result.Result = result.Result == "1" ? true : false;
return result;
}
}
}


就是jQuery.Ajax方法dataFilter,可以在AJAX請求成功後將數據進行過濾處理,這裏我就使用了jQuery方法把結果和消息從XML中獲取出來直接賦給一個對象,再將這個對象返回,交由ajaxsuccess使用。

這樣就算是完成了修改jQuery.Validate的remote方法,使得可以返回驗證結果及驗證消息,看下效果圖:

pic25

第三點:在反覆使用jQuery.Validate進行AJAX驗證時,總是需要編寫相關AJAX參數,可否進行進一步封裝?(具體見High-3.aspx和jquery.validate.extension.js)

在開發一個系統的時候經常會用到AJAX的驗證,而如果每次都要編寫上面那麼多的代碼還是很不方便,所以我現在就來進行一下簡單的封裝,代碼如下:

//遠程驗證抽象方法
function GetRemoteInfo(postUrl, data) {
var remote = {
type: "POST",
async: false,
url: postUrl,
dataType: "xml",
data: data,
dataFilter: function(dataXML) {
var result = new Object();
result.Result = jQuery(dataXML).find("Result").text();
result.Msg = jQuery(dataXML).find("Msg").text();
if (result.Result == "-1") {
result.Result = false;
return result;
}
else {
result.Result = result.Result == "1" ? true : false;
return result;
}
}
};
return remote;
}


這個函數主要接收2個參數,一個是遠程驗證的路徑和需要提交的參數,返回包裝好的remote對象。

頁面調用也很簡單,代碼如下:

<script src="scripts/jquery.validate.extension.js" type="text/javascript"></script>
<script type="text/javascript">
function InitRules() {
var dataInfo = {uid:function(){ return jQuery("#<%=txtUid.ClientID %>").val();}};
var remoteInfo = GetRemoteInfo('WebService.asmx/CheckUid', dataInfo);
opts = {
rules:
{
<%=txtUid.UniqueID %>: 
{
required: true,
remote:remoteInfo
}
}
}
}
</script>


怎麼樣?相比上面的代碼一下子乾淨了很多吧?

頁面上只要做3步操作:

1、包裝好需要提交的data對象。

2、將遠程驗證地址和包裝好的data對象傳遞給封裝好的方法獲取remote對象。

3、將函數返回的remote對象放入規則中。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章