1、用前必備
官方網站: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>javascript
2、默認校驗規則
(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 輸入值不能小於10php
3、默認的提示css
如須要修改,可在js代碼中加入:html
推薦作法,將此文件放入messages_cn.js中,在頁面中引入java
4、使用方式
1.將校驗規則寫到控件中jquery
使用class="{}"的方式,必須引入包:jquery.metadata.jsgit
可使用以下的方法,修改提示內容:web
在使用equalTo關鍵字時,後面的內容必須加上引號,以下代碼:ajax
另一個方式,使用關鍵字:meta(爲了元數據使用其餘插件你要包裝 你的驗證規則 在他們本身的項目中能夠用這個特殊的選項)正則表達式
Tell the validation plugin to look inside a validate-property in metadata for validation rules.
例如:
再有一種方式:
這樣可使用validate="{required:true}"的方式,或者class="required",但class="{required:true,minlength:5}"將不起做用
2.將校驗規則寫到代碼中
required:true 必須有值
required:"#aa:checked"表達式的值爲真,則須要驗證
required:function(){}返回爲真,表時須要驗證
後邊兩種經常使用於,表單中須要同時填或不填的元素
5、經常使用方法及注意問題
1.用其餘方式替代默認的SUBMIT
能夠設置validate的默認值,寫法以下:
若是想提交表單, 須要使用form.submit()而不要使用$(form).submit()
2.debug,若是這個參數爲true,那麼表單不會提交,只進行檢查,調試時十分方便
若是一個頁面中有多個表單,用
3.ignore:忽略某些元素不驗證
4.errorPlacement:Callback Default: 把錯誤信息放在驗證的元素後面
指明錯誤放置的位置,默認狀況是:error.appendTo(element.parent());即把錯誤信息放在驗證的元素後面
errorPlacement: function(error, element) {
error.appendTo(element.parent());
}
//示例:
errorClass:String Default: "error"
指定錯誤提示的css類名,能夠自定義錯誤提示的樣式
errorElement:String Default: "label"
用什麼標籤標記錯誤,默認的是label你能夠改爲em
errorContainer:Selector
顯示或者隱藏驗證信息,能夠自動實現有錯誤信息出現時把容器屬性變爲顯示,無錯誤時隱藏,用處不大
errorContainer: "#messageBox1, #messageBox2"
errorLabelContainer:Selector
把錯誤信息統一放在一個容器裏面。
wrapper:String
用什麼標籤再把上邊的errorELement包起來
通常這三個屬性同時使用,實如今一個容器內顯示全部錯誤提示的功能,而且沒有信息時自動隱藏
設置錯誤提示的樣式,能夠增長圖標顯示
要驗證的元素經過驗證後的動做,若是跟一個字符串,會當作一個css類,也可跟一個函數
添加"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 一塊兒用
// 重置表單
remote:URL
使用ajax方式進行驗證,默認會提交當前驗證的值到遠程地址,若是須要提交其餘的值,可使用data選項
遠程地址只能輸出 "true" 或 "false",不能有其它輸出
addMethod:name, method, message
自定義驗證方法
radio和checkbox、select的驗證
radio的required表示必須選中一個
//////////////////////////////////////////////////////////////////////////////////////////////
jQuery.Validate是監控form,在任何提交表單的操做前jQuery.Validate都會檢測表單裏的輸入項是否知足規則,知足才容許提交。因此需
要在jQuery(document).ready()時爲form進行驗證註冊
具體代碼以下:
jQuery.Validate爲咱們提供了3種驗證編寫方式,各有優缺點:
一、在input對象中書寫class樣式指定驗證規則或屬性驗證規則:
如<input type=」text」 class=」required」/>
最簡單、最便捷,提示消息使用jQuery.Validate的內置的消息(自定義擴展驗證規則也屬於此項),可是因爲是以樣式名的方式進行驗證,致使了往後修改必須找到相應的input對象,同時沒法使用高級驗證規則,具體說明請向下看
二、同第1條,這種驗證規則方式也是在input對象中書寫class樣式,只不過書寫的方式改成了JSON格式,可是這種方式提供了自定義驗證消息的支持:
如<input type=」text」 class="{required:true,minlength:5,,messages:{required:'請輸入內容'}」/>
簡單、方便,但我的認爲有點臃腫,仍是和第1條同樣和相對應的input對象糾纏在一塊兒,而且還增長消息自定義,使得input對象變的更大了,干擾了頁面代碼的閱讀,但可使用高級驗證規則(實際就是將第3種JS以JSON的格式放到具體的class中
三、這種方式使用純JS的方式:
如:
$().ready(function() {
$("#aspnetform").validate({
rules: {
name: "required",
email: {
required: true,
email: true
}})
})
很好的解決了HTML和驗證規則的分離,就是書寫較爲麻煩,須要單獨寫JS腳本,但好處是能夠統一驗證規範,將每一個頁面的驗證規則都寫在頭部的腳本中,方便往後維護。
注意:以上3種驗證方式的消息若是未指定都會默認調用內置的消息
一、在使用上一篇中第2種方式,以JSON的格式編寫驗證規則,影響了正常的class使用,如何處理?
二、在ASP.NET下,全部的按鈕都會提交form表單,因此都會引起驗證,如何處理?
三、我但願驗證的提示信息能夠在統一的地方顯示,如何處理?
四、我在開發的過程當中,我不肯定所編寫的規則是否正確,如何進行調試?
五、我使用的是微軟AJAX控件,想監控dropdownlist是否選擇,爲什麼不起做用?
六、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頁面,而提交按鈕就一個,這時就須要將驗證提示信息統一放在一個位置,好方便查看,如圖:
要實現這個效果只需在JS編寫驗證規則時添加:
errorPlacement: function(error, element) {
error.html(error.html()+"<br/>");
error.appendTo("#errorContainer");
}
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應用的例子,由於官方的例子已經寫的很是好了。
一、擴展驗證規則,jQuery.Validate只提供了一些基本的驗證功能,並不能知足咱們平常開發的需求,因此咱們要爲jQuery.Validate擴展驗證規則。
二、分組驗證,在開發的時候有時會遇到的一個問題就是,不一樣按鈕引起不一樣的驗證。
首先來介紹下第一點:擴展驗證規則,在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頁面須要不一樣的提交按鈕:
這2個就是標準的分組驗證狀況,若是不設置分組驗證的狀況下,點擊[基本信息提交]和[描述提交]按鈕後頁面上全部的驗證都會被相應,這是由於2個按鈕都在一個form表單中,2個按鈕的點擊事件默認都是在客戶端提交表單,而後由服務器端來分配執行代碼,因此問題就出現了。
這時咱們就須要引入分組驗證了,這個解決思路是我在一個國外的網站找到的,不過具體地址我找不到了,這個方法有個弊端就是必須是將須要分組的控件必須放入不一樣的容器中,如div,table等,由於採用的是標識class樣式來進行分組驗證。
看下具體代碼:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
//初始化分組驗證
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元素下的全部有驗證規則的元素判斷是否驗證經過。
頁面代碼:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
<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()中的帶代碼:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
if
(isValidationGroup) {
if
(opts != undefined || opts !=
null
) {
jQuery(
"#<%=form1.ClientId %>"
).validate(jQuery.extend(opts, { onsubmit:
false
}));
}
else
{
jQuery(
"#<%=form1.ClientId %>"
).validate({
onsubmit:
false
});
|