客户端验证:JQuery Validation Plugin
jQuery Validate驗(yàn)證框架詳解
jQuery校驗(yàn)官網(wǎng)地址:http://bassistance.de/jquery-plugins/jquery-plugin-validation
一、導(dǎo)入js庫
<script type="text/javascript" src="<%=path %>/validate/jquery-1.6.2.min.js"></script> <script type="text/javascript" src="<%=path %>/validate/jquery.validate.min.js"></script>注:<%=request.getContextPath() %>返回web項(xiàng)目的根路徑。
二、默認(rèn)校驗(yàn)規(guī)則
(1)、required:true 必輸字段 (2)、remote:"remote-valid.jsp" 使用ajax方法調(diào)用remote-valid.jsp驗(yàn)證輸入值 (3)、email:true 必須輸入正確格式的電子郵件 (4)、url:true 必須輸入正確格式的網(wǎng)址 (5)、date:true 必須輸入正確格式的日期,日期校驗(yàn)ie6出錯,慎用 (6)、dateISO:true 必須輸入正確格式的日期(ISO),例如:2009-06-23,1998/01/22 只驗(yàn)證格式,不驗(yàn)證有效性 (7)、number:true 必須輸入合法的數(shù)字(負(fù)數(shù),小數(shù)) (8)、digits:true 必須輸入整數(shù) (9)、creditcard:true 必須輸入合法的信用卡號 (10)、equalTo:"#password" 輸入值必須和#password相同 (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三、默認(rèn)的提示
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代碼中加入:
$.extend($.validator.messages, {required: "必選字段",remote: "請修正該字段",email: "請輸入正確格式的電子郵件",url: "請輸入合法的網(wǎng)址",date: "請輸入合法的日期",dateISO: "請輸入合法的日期 (ISO).",number: "請輸入合法的數(shù)字",digits: "只能輸入整數(shù)",creditcard: "請輸入合法的信用卡號",equalTo: "請?jiān)俅屋斎胂嗤闹?#34;,accept: "請輸入擁有合法后綴名的字符串",maxlength: $.validator.format("請輸入一個長度最多是 {0} 的字符串"),minlength: $.validator.format("請輸入一個長度最少是 {0} 的字符串"),rangelength: $.validator.format("請輸入一個長度介于 {0} 和 {1} 之間的字符串"),range: $.validator.format("請輸入一個介于 {0} 和 {1} 之間的值"),max: $.validator.format("請輸入一個最大為 {0} 的值"),min: $.validator.format("請輸入一個最小為 {0} 的值") });推薦做法,將此文件放入messages_cn.js中,在頁面中引入
<script type="text/javascript" src="<%=path %>/validate/messages_cn.js"></script>四、使用方式
1、metadata用法,將校驗(yàn)規(guī)則寫到控件中
使用class="{}"的方式,必須引入包:jquery.metadata.js;
可以使用如下的方法,修改提示內(nèi)容:class="{required:true,minlength:5,messages:{required:'請輸入內(nèi)容'}}";
在使用equalTo關(guān)鍵字時,后面的內(nèi)容必須加上引號,如下代碼:class="{required:true,minlength:5,equalTo:'#password'}"。
2、將校驗(yàn)規(guī)則寫到j(luò)s代碼中
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> <%String path = request.getContextPath();String basePath = request.getScheme() + "://" + request.getServerName() + ":"+ request.getServerPort() + path + "/"; %><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html><head><base href="<%=basePath%>"><title>jQuery Validate驗(yàn)證框架詳解</title><meta http-equiv="pragma" content="no-cache"><meta http-equiv="cache-control" content="no-cache"><meta http-equiv="expires" content="0"><meta http-equiv="keywords" content="keyword1,keyword2,keyword3"><meta http-equiv="description" content="This is my page"><script type="text/javascript" src="<%=request.getContextPath()%>/validate/jquery-1.6.2.min.js"></script><script type="text/javascript" src="<%=request.getContextPath()%>/validate/jquery.validate.min.js"></script><script type="text/javascript">$(function(){var validate = $("#myform").validate({debug: true, //調(diào)試模式取消submit的默認(rèn)提交功能 //errorClass: "label.error", //默認(rèn)為錯誤的樣式類為:error focusInvalid: false, //當(dāng)為false時,驗(yàn)證無效時,沒有焦點(diǎn)響應(yīng) onkeyup: false, submitHandler: function(form){ //表單提交句柄,為一回調(diào)函數(shù),帶一個參數(shù):form alert("提交表單"); form.submit(); //提交表單 }, rules:{myname:{required:true},email:{required:true,email:true},password:{required:true,rangelength:[3,10]},confirm_password:{equalTo:"#password"} },messages:{myname:{required:"必填"},email:{required:"必填",email:"E-Mail格式不正確"},password:{required: "不能為空",rangelength: $.format("密碼最小長度:{0}, 最大長度:{1}。")},confirm_password:{equalTo:"兩次密碼輸入不一致"} }}); });</script></head><body><form id="myform" method="post" action=""><p><label for="myname">用戶名:</label><!-- id和name最好同時寫上 --><input id="myname" name="myname" /></p><p><label for="email">E-Mail:</label><input id="email" name="email" /></p><p><label for="password">登陸密碼:</label><input id="password" name="password" type="password" /></p><p><label for="confirm_password">確認(rèn)密碼:</label><input id="confirm_password" name="confirm_password" type="password" /></p><p><input class="submit" type="submit" value="立即注冊" /></p></form></body> </html>五、常用方法及注意問題
1、用其他方式替代默認(rèn)的submit
可以設(shè)置validate的默認(rèn)值,寫法如下:
$.validator.setDefaults({
submitHandler: function(form) { alert("submit!"); form.submit(); }
});
如果想提交表單,需要使用form.submit(),而不要使用$(form).submit()
2、debug,只驗(yàn)證不提交表單
如果這個參數(shù)為true,那么表單不會提交,只進(jìn)行檢查,調(diào)試時十分方便
如果一個頁面中有多個表單都想設(shè)置成為debug,用
$.validator.setDefaults({
debug: true
})
3、ignore:忽略某些元素不驗(yàn)證
ignore: ".ignore"
4、更改錯誤信息顯示的位置
errorPlacement:Callback
Default: 把錯誤信息放在驗(yàn)證的元素后面
指明錯誤放置的位置,默認(rèn)情況是:error.appendTo(element.parent());即把錯誤信息放在驗(yàn)證的元素后面
errorPlacement: function(error, element) {
? ? ?error.appendTo(element.parent());
}
//示例
<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>errorPlacement: function(error, element) {if (element.is(":radio"))error.appendTo(element.parent().next().next());else if (element.is(":checkbox"))error.appendTo(element.next());elseerror.appendTo(element.parent().next()); }代碼的作用是:一般情況下把錯誤信息顯示在<td class="status"></td>中,如果是radio顯示在<td></td>中,如果是checkbox顯示在內(nèi)容的后面
errorClass:String Default: "error"
指定錯誤提示的css類名,可以自定義錯誤提示的樣式
errorElement:String Default: "label"
用什么標(biāo)簽標(biāo)記錯誤,默認(rèn)的是label你可以改成em
errorContainer:Selector
顯示或者隱藏驗(yàn)證信息,可以自動實(shí)現(xiàn)有錯誤信息出現(xiàn)時把容器屬性變?yōu)轱@示,無錯誤時隱藏,用處不大
errorContainer: "#messageBox1, #messageBox2"
errorLabelContainer:Selector
把錯誤信息統(tǒng)一放在一個容器里面。
wrapper:String
用什么標(biāo)簽再把上邊的errorELement包起來
一般這三個屬性同時使用,實(shí)現(xiàn)在一個容器內(nèi)顯示所有錯誤提示的功能,并且沒有信息時自動隱藏
errorContainer: "div.error",
errorLabelContainer: $("#signupForm div.error"),
wrapper: "li"
5、更改錯誤信息顯示的樣式
設(shè)置錯誤提示的樣式,可以增加圖標(biāo)顯示,在該系統(tǒng)中已經(jīng)建立了一個validation.css專門用于維護(hù)校驗(yàn)文件的樣式
6、每個字段驗(yàn)證通過執(zhí)行函數(shù)
success:String,Callback
要驗(yàn)證的元素通過驗(yàn)證后的動作,如果跟一個字符串,會當(dāng)做一個css類,也可跟一個函數(shù)
success: function(label) {// set as text for IElabel.html(" ").addClass("checked");//label.addClass("valid").text("Ok!") }添加"valid"到驗(yàn)證元素, 在CSS中定義的樣式<style>label.valid {}</style>
success: "valid"
7、驗(yàn)證的觸發(fā)方式修改
下面的雖然是boolean型的,但建議除非要改為false,否則別亂添加。
a.onsubmit:Boolean Default: true
提交時驗(yàn)證. 設(shè)置唯false就用其他方法去驗(yàn)證
b.onfocusout:Boolean Default: true
失去焦點(diǎn)是驗(yàn)證(不包括checkboxes/radio buttons)
c.onkeyup:Boolean Default: true
在keyup時驗(yàn)證.
d.onclick:Boolean Default: true
在checkboxes 和 radio 點(diǎn)擊時驗(yàn)證
e.focusInvalid:Boolean Default: true
提交表單后,未通過驗(yàn)證的表單(第一個或提交之前獲得焦點(diǎn)的未通過驗(yàn)證的表單)會獲得焦點(diǎn)
f.focusCleanup:Boolean Default: false
如果是true那么當(dāng)未通過驗(yàn)證的元素獲得焦點(diǎn)時,移除錯誤提示。避免和focusInvalid一起用
8、異步驗(yàn)證
remote:URL
使用ajax方式進(jìn)行驗(yàn)證,默認(rèn)會提交當(dāng)前驗(yàn)證的值到遠(yuǎn)程地址,如果需要提交其他的值,可以使用data選項(xiàng)
遠(yuǎn)程地址只能輸出"true"或"false",不能有其它輸出。
9、添加自定義校驗(yàn)
addMethod:name, method, message
自定義驗(yàn)證方法
1.要在additional-methods.js文件中添加或者在jquery.validate.js添加
建議一般寫在additional-methods.js文件中
2.在messages_cn.js文件添加:isZipCode: "只能包括中文字、英文字母、數(shù)字和下劃線",
調(diào)用前要添加對additional-methods.js文件的引用。
10、radio和checkbox、select的驗(yàn)證
1.radio的required表示必須選中一個 <input type="radio" id="gender_male" value="m" name="gender" class="{required:true}" /> <input type="radio" id="gender_female" value="f" name="gender"/>2.checkbox的required表示必須選中 <input type="checkbox" class="checkbox" id="agree" name="agree" class="{required:true}" />checkbox的minlength表示必須選中的最小個數(shù),maxlength表示最大的選中個數(shù),rangelength:[2,3]表示選中個數(shù)區(qū)間 <input type="checkbox" id="spam_email" value="email" name="spam[]" class="{required:true, minlength:2}" /> <input type="checkbox" id="spam_phone" value="phone" name="spam[]" /> <input type="checkbox" id="spam_mail" value="mail" name="spam[]" />3.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表示選中的最小個數(shù)(可多選的select),maxlength表示最大的選中個 數(shù),rangelength:[2,3]表示選中個數(shù)區(qū)間 <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>總結(jié)
以上是生活随笔為你收集整理的客户端验证:JQuery Validation Plugin的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 命令行神器 Click 简明笔记
- 下一篇: Java基础运算符