網路上基於 jQuery 的表單驗證外掛已經很多,但我還是做了這一個。原因有兩個:它是從我過去的個人 JavaScript 框架移植而來(我已慢慢投入 jQuery 的懷抱),而且它的規則撰寫方式可能會讓你眼前一亮。
多數驗證外掛把規則集中寫在 script 區塊,而這個外掛把規則直接寫在表單元素的屬性上:
<input name="name" type="text" id="name" size="30"
jvpattern="^.+$"
jverrortip="請輸入正確的姓名."
jvtipid="spt_name"
jvmethod="checkname" />
<span id="spt_name" class="normaltips"
jverrorclass="errortips"
jvcorrectclass="correcttips"></span>
注意程式碼中以「jv」開頭的那些屬性,它們都是驗證外掛要讀取的設定值。
jvpattern:用來驗證控件值是否正確的正規表達式。(可不定義)
jvcompareid:需要與當前控件做「值相等」比較的其他控件 id,常用於密碼確認欄位。(可不定義)
jvrequired:標明當前控件值是否必填,也就是是否允許為空。不定義時預設不可為空;若值為 false 或 0 則允許留空。(可不定義)
jvmethod:定義需要額外驗證的方法。(可不定義)若定義此屬性,不需要寫「括號」,函數原型為:
function(item){
// 程式碼
// true 表示驗證成功,false 表示驗證失敗
return true/false;
// 或者帶錯誤訊息地回傳
return { result: true/false, message: '錯誤訊息' };
}
其中 item 參數是當前控件物件的 jQuery 實例。
jvtipid:顯示驗證提示資訊的控件 id。(可不定義)若未定義此屬性,且未定義 onerror 或 oncorrect 函數,則預設改用 alert 提示。
jverrortip:驗證失敗時要顯示的提示文字。(可不定義)
jvcorrecttip:驗證成功時要顯示的提示文字。(可不定義)
jvfocuson:驗證失敗後是否要把游標移到該控件上。(可不定義)
重要限制:控件上必須至少定義 jvpattern、jvmethod、jvcompareid 三者中的一個,否則外掛不會對該控件進行驗證。
提示控件即由某個表單控件的 jvtipid 所指定的元素。
jvnormalclass:正常狀態顯示提示時套用的 CSS class 名稱。(可不定義)
jvcorrectclass:驗證成功後顯示提示時套用的 CSS class 名稱。(可不定義)
jverrorclass:驗證失敗後顯示提示時套用的 CSS class 名稱。(可不定義)
規則設定好之後,直接呼叫 jValidate,即可在表單 submit 前進行檢查:
$('form').jValidate();
或帶參數呼叫:
$('form').jValidate({
blurvalidate : true,
isbubble : false,
onerror : function(item, form){
$.jMessageBox.show('錯誤', item.attr('jverrortip'));
}
});
可用參數說明
isbubble:是否允許「冒泡」,也就是是否逐個檢查各控件值。若為 true,會逐一驗證所有已設定規則的控件;若為 false,只要有一個控件驗證失敗就退出後續檢查。預設為 false。
補充:若提示是以彈出視窗方式顯示,建議設為 false,以免一次彈出過多提示引起使用者反感。
blurvalidate:控件失去焦點後是否立即驗證。預設為 false。
emptytip:是否允許空提示。也就是當沒有提示文字可顯示時,是否仍允許提示控件切換 CSS class。預設為 false。
oncorrect:控件值驗證成功時呼叫的處理函數,未定義則採用預設行為。原型為 function(item, form){ ... },其中 item 是當前控件的 jQuery 實例,form 是控件所在的表單實例。
onerror:控件值驗證失敗時呼叫的處理函數,未定義則採用預設行為,參數同上。
效果示意:

原始碼下載(壓縮檔附 jMessageBox 範例):/Files/kingthy/jvalidate.zip