DIV CSS 佈局教程網

jValidate:把驗證規則寫在 HTML 屬性裡的 jQuery 表單驗證外掛
編輯:關於JavaScript     

網路上基於 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

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved