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

既可以直接在標籤上宣告規則:
<input id="vv" required="true" validType="email">
也可以用程式方式設定:
$('#vv').validatebox({ required: true });
規則透過 required 與 validType 兩個屬性定義,目前提供的 validType 有:
其中 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。這個設計讓同一條規則能透過參數變化套用在不同欄位上,不必重複撰寫。
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| required | boolean | 是否要求此欄位必須填寫。 | false |
| validType | string | 驗證類型,如 email、url 或自訂規則。 | null |
| missingMessage | string | 欄位為空時顯示的提示文字。 | This field is required. |
| invalidMessage | string | 欄位內容格式錯誤時顯示的提示文字。 | null |
| 名稱 | 參數 | 說明 |
|---|---|---|
| destroy | none | 移除並銷毀這個元件。 |
| validate | none | 執行驗證,判斷內容是否有效。 |
| isValid | none | 呼叫 validate 並回傳 true 或 false。 |
實務上常見的做法是在表單送出前,逐一呼叫各欄位的 isValid,或用 form 元件的 validate 方法一次驗證整份表單,全部通過後才真正送出資料。