兩個(gè)概念:
method:驗(yàn)證方法蓝撇,指的是校驗(yàn)的邏輯
rule :驗(yàn)證規(guī)則,指的是元素和驗(yàn)證方法的關(guān)聯(lián)
validate()方法:validation插件的核心方法岁疼,定義了基本的校驗(yàn)規(guī)則和一些有用的配置項(xiàng)俐载。
如:debug參數(shù)設(shè)置為true,則表單不會(huì)提交缎岗,只進(jìn)行檢查,用于調(diào)試白粉。
validation插件的基本驗(yàn)證方法之一:
1传泊、required:必填校驗(yàn)(true表示必填)
2鼠渺、remote:遠(yuǎn)程校驗(yàn),用于通過(guò)訪問(wèn)服務(wù)器來(lái)校驗(yàn)數(shù)據(jù)的有效性眷细;
如校驗(yàn)用戶名是否存在
remote用法:
1拦盹、remote使用get請(qǐng)求訪問(wèn)服務(wù)器
訪問(wèn)服務(wù)器后返回校驗(yàn)結(jié)果:正常的時(shí)候返回true,檢驗(yàn)不通過(guò)的時(shí)候返回錯(cuò)誤提示信息
remote:url
2溪椎、remote使用post請(qǐng)求訪問(wèn)服務(wù)器
remote:{
url:請(qǐng)求地址
type:請(qǐng)求類型post/get
data:{
需要傳遞的參數(shù)
}
}
validation插件的基本驗(yàn)證方法之二:
長(zhǎng)度校驗(yàn):
3普舆、minlength:最小長(zhǎng)度驗(yàn)證
4、maxlength:最大長(zhǎng)度驗(yàn)證
5校读、rangelength:長(zhǎng)度范圍沼侣,
如:rangelength:[minlength,maxlength]可用于代替minlength和maxlength
數(shù)值校驗(yàn)
6、min:數(shù)值最小值校驗(yàn)
7歉秫、max:數(shù)值最大值校驗(yàn)
8蛾洛、range:數(shù)值范圍校驗(yàn),
range:[min,max]可代替min和max
PS:以上驗(yàn)證方法的值都為數(shù)字
validation插件的基本驗(yàn)證方法之三:
9端考、email:Email格式校驗(yàn)
10雅潭、url:url格式校驗(yàn),需要帶“http://”或“https://”等前綴
11却特、date:日期校驗(yàn),使用的是js的date類型筛圆,只要能被Date.parse識(shí)別的都是有效的
12裂明、dateISO:ISO日期校驗(yàn),格式必須為yyyy/MM/dd或yyyy-MM-dd的
PS:以上驗(yàn)證方法的值都是boolean類型太援,true表示進(jìn)行驗(yàn)證
validation插件的基本驗(yàn)證方法之四:
13闽晦、number:數(shù)字驗(yàn)證,任意整形提岔、非整形仙蛉、負(fù)數(shù)、整數(shù)皆可
14碱蒙、digits:整數(shù)驗(yàn)證荠瘪,必須為大于等于0的數(shù)字
PS:以上驗(yàn)證方法的值為boolean,true表示進(jìn)行驗(yàn)證
15赛惩、equalTo:與另一個(gè)元素值相等驗(yàn)證哀墓,值為選擇器,表示是和那一個(gè)元素的值比較
如:equalTo:"#password"喷兼,表示用當(dāng)前元素的值和id="password"元素的值相比較
$("#form").valid()?"correct":"error"; //valid()方法:檢查表單或某些元素是否有效篮绰,返回值為boolean型,
全部通過(guò)檢查規(guī)則返回true季惯,只要有不通過(guò)的檢查規(guī)則都返回false
rules只針對(duì)表單里的元素吠各,而不是某個(gè)整個(gè)表單(會(huì)拋出錯(cuò)誤)
1.可以使用rules("add",{})的方法來(lái)為元素添加規(guī)則臀突,如:
$("#username").rules("add",{minlength:2,maxlength:10})
2.可以使用rules("remove",{})的方法來(lái)為元素去掉規(guī)則,如:
$("#username").rules("remove","email")
3.可以使用rules()無(wú)參數(shù)的方法來(lái)獲取規(guī)則
valid()方法
檢查表單或者某些元素是否有錯(cuò)誤
$("#form").valid();返回值為布爾型贾漏;
validate方法返回Validator對(duì)象惧辈,Validator對(duì)象的方法如下:
1、Validator.form():驗(yàn)證表單是否有效磕瓷,返回true/false盒齿;
2、Validator.element(element):驗(yàn)證某個(gè)元素是否有效困食,返回true/false边翁;
如:validator.element("#username")
3、Validator.resetForm():把表單恢復(fù)到驗(yàn)證前原來(lái)的狀態(tài)硕盹,會(huì)清除顯示的驗(yàn)證錯(cuò)誤信息
4符匾、Validator.showErrors(errors):針對(duì)某個(gè)元素顯示特定的錯(cuò)誤信息
如:Validator.showErrors({username:"xxxxxx",passworld:"xxxxx"}),新的錯(cuò)誤信息會(huì)立即顯示
5瘩例、Validator.numberOfInvailds():返回?zé)o效(即沒(méi)通過(guò)驗(yàn)證的)的元素?cái)?shù)量
Validator對(duì)象的靜態(tài)方法:
1啊胶、jQuery.validator.addMethod(name,method[,message]):增加自定義的驗(yàn)證方法
2、jQuery.validator.format(template,argument,argumentN...):格式化字符串垛贤,用參數(shù)代替模板中的{n}
如:var template=$.validator.format("{0}-{1}-{2}");
template("你","我","他")或template(["你","我","他"])則輸出"你-我-他"焰坪,參數(shù)個(gè)數(shù)不夠則會(huì)輸出{n}來(lái)代替
3、jQuery.validator.setDefaults(options):修改插件默認(rèn)設(shè)置
如:$.validator.setDefaults({debug:true});表示給所有的表單都設(shè)置
4聘惦、jQuery.validator.addClassRules(name,rules):為某些class屬性值包含name的元素增加組合(批量)驗(yàn)證規(guī)則
如:$.validator.addClassRules({text:{required:true,minlength:5}});表示給class="text"的元素添加驗(yàn)證規(guī)則
validate()方法配置項(xiàng)一:
--submitHandler:通過(guò)驗(yàn)證后運(yùn)行的函數(shù)某饰,可以加上表單的提交方法
submitHandler:function(form){
//提交表單或者其他的操作都可以,參數(shù)form是表單的document對(duì)象
form.submit();//提交表單,$(form).submit();//不能提交成功
}
--invalidHandler:無(wú)效表單提交后運(yùn)行的函數(shù)
如:invalidHandler:function(event,validator){
//event:無(wú)效驗(yàn)證觸發(fā)的事件
//validator:對(duì)象
}
也可以寫事件來(lái)觸發(fā)invalidHandler的event事件善绎,如:
$("#form").on("invalid-form",function(event,validator){
})
--ignore:對(duì)某些元素不進(jìn)行驗(yàn)證
--rules:定義校驗(yàn)規(guī)則
--messages:定義提示信息
groups:對(duì)一組元素的驗(yàn)證黔漂,用一個(gè)錯(cuò)誤提示,用errorPlacement控制把錯(cuò)誤信息放在哪里
rules中的校驗(yàn)方法都可以定義depends屬性禀酱,表示當(dāng)條件滿足時(shí)返回true炬守,則執(zhí)行校驗(yàn)方法
針對(duì)參數(shù)為boolean類型的校驗(yàn)方法:
required:{
//只有depends:function(element)返回true,required校驗(yàn)方法才起作用
depends:function(element){
//:filled是Validation自帶的選擇器剂跟,匹配填寫內(nèi)容的元素
return $("#password").is(":filled")
}
}
針對(duì)參數(shù)為非boolean類型的校驗(yàn)方法如下:
maxlength:{
param:2
//只有depends:function(element)返回true减途,maxlength校驗(yàn)方法的值才設(shè)置為2
depends:function(element){
//:filled是Validation自帶的選擇器,匹配填寫內(nèi)容的元素
return $("#password").is(":filled")
}
}
}
groups的使用如下:
groups:{login:"username password confirm-password"} //對(duì)一組元素進(jìn)行驗(yàn)證
errorPlacement:function(error,element){ //對(duì)一組元素驗(yàn)證后錯(cuò)誤信息顯示
error.insertBefore("#info");//將一組元素的錯(cuò)誤信息都顯示在id="info"的元素上
}
validate()方法配置項(xiàng)
onsubmit:是否在提交時(shí)驗(yàn)證浩聋,默認(rèn)值為true
onfoucusout:是否在獲取焦時(shí)驗(yàn)證
onkeyup:是否在敲擊鍵盤時(shí)驗(yàn)證
onclick:是否在鼠標(biāo)點(diǎn)擊時(shí)驗(yàn)證观蜗,一般用于checkbox或者radio
focusInvalid:提交表單后,未通過(guò)驗(yàn)證的表單(第一個(gè)或提交之前獲得焦點(diǎn)的未通過(guò)驗(yàn)證的 表單)是否會(huì)獲得焦點(diǎn)
focusCleanup:當(dāng)未通過(guò)驗(yàn)證的元素獲得焦點(diǎn)時(shí)衣洁,是否移除錯(cuò)誤提示
errorClass:指定錯(cuò)誤提示的css類名墓捻,可以自定義錯(cuò)誤提示的樣式
validClass:指定驗(yàn)證通過(guò)的css類名
errorElement:使用什么標(biāo)簽標(biāo)記錯(cuò)誤
wrapper:使用什么標(biāo)簽把上邊的errorElement包起來(lái)
errorLaberContainer:把錯(cuò)誤信息統(tǒng)一放在一個(gè)容器里面
errorContainer:顯示或者隱藏驗(yàn)證信息,可以自動(dòng)實(shí)現(xiàn)有錯(cuò)誤信息出現(xiàn)時(shí)把容器屬性變?yōu)轱@示,無(wú)錯(cuò)誤時(shí)隱藏砖第。
validate()方法配置項(xiàng)之四:
1撤卢、showErrors:可以顯示總共有多少個(gè)未通過(guò)驗(yàn)證的元素
如:showErrors:function(errorMap,errorList){
errorMap:元素信息和錯(cuò)誤信息的鍵值對(duì)
errorList:元素信息、錯(cuò)誤信息梧兼、驗(yàn)證方法等信息列表
this.defaultShowErrors();//使用默認(rèn)的錯(cuò)誤提示信息展示方式放吩,需要這個(gè)否則錯(cuò)誤信息不顯示了
}
2、errorPlacement:自定義錯(cuò)誤信息放在哪里羽杰,配合groups一起使用
3渡紫、success:要驗(yàn)證的元素通過(guò)驗(yàn)證后的動(dòng)作
如:success:"right" 或 success:function(label){label.addClass("right")}
效果是給錯(cuò)誤信息展示label元素的class屬性值追加right值
4、highlight:可以給未通過(guò)驗(yàn)證的元素加效果
如:highlight:function(element,errorClass,validClass){
//element:綁定驗(yàn)證的元素
//errorClass:驗(yàn)證錯(cuò)誤信息展示label的class屬性值
//validClass:驗(yàn)證通過(guò)信息展示label的class屬性值
}
5考赛、unhighlight:去除未通過(guò)驗(yàn)證的元素的效果惕澎,一般和highlight同時(shí)使用,同上
注意:success主要針對(duì)label元素颜骤,highlight主要針對(duì)input元素
highlight和unhighlight主要用在單項(xiàng)驗(yàn)證時(shí)