DIV CSS 佈局教程網

jQuery EasyUI 的 ValidateBox 驗證框:規則、訊息與自訂驗證
編輯:JQuery特效代碼     

預設值可透過 $.fn.validatebox.defaults 覆寫。

用法

既可以直接在標籤上宣告規則:

<input id="vv" required="true" validType="email">

也可以用程式方式設定:

$('#vv').validatebox({ required: true });

內建驗證規則

規則透過 required 與 validType 兩個屬性定義,目前提供的 validType 有:

  • email:比對電子郵件格式的正則表達式。
  • url:比對網址格式的正則表達式。
  • length[0,100]:限定輸入長度介於 x 到 y 個字元之間。
  • remote['https://.../action.do','paramName']:送出 Ajax 請求向伺服器驗證,成功時回傳 'true'。

其中 remote 特別有用:帳號是否已被註冊、邀請碼是否有效這類必須查詢資料庫的判斷,都適合用這種方式處理。

自訂驗證規則

要新增規則,只要擴充 $.fn.validatebox.defaults.rules,提供一個驗證函數與錯誤訊息即可。以下定義一個 minLength 類型:

$.extend($.fn.validatebox.defaults.rules, {
    minLength: {
        validator: function(value, param){
            return value.length >= param[0];
        },
        message: '請至少輸入 {0} 個字元。'
    }
});

定義完成後即可直接使用,例如要求至少輸入 5 個字元:

<input class="easyui-validatebox" validType="minLength[5]">

方括號內的值會以陣列形式傳入 validator 的第二個參數 param,因此 param[0] 就是 5。這個設計讓同一條規則能透過參數變化套用在不同欄位上,不必重複撰寫。

屬性

名稱類型說明預設值
requiredboolean是否要求此欄位必須填寫。false
validTypestring驗證類型,如 email、url 或自訂規則。null
missingMessagestring欄位為空時顯示的提示文字。This field is required.
invalidMessagestring欄位內容格式錯誤時顯示的提示文字。null

方法

名稱參數說明
destroynone移除並銷毀這個元件。
validatenone執行驗證,判斷內容是否有效。
isValidnone呼叫 validate 並回傳 true 或 false。

實務上常見的做法是在表單送出前,逐一呼叫各欄位的 isValid,或用 form 元件的 validate 方法一次驗證整份表單,全部通過後才真正送出資料。

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