EasyUI 的 validatebox 把表單驗證抽象成「宣告式」:只要為輸入框標上 validtype,框架就會在失焦或提交時自動檢查,並顯示提示訊息。當內建規則無法覆蓋業務需求時,也可以通过擴充規則表快速補上。
先載入 jQuery、EasyUI 與自定義規則檔,然後在 ready 階段對目標輸入框啟用 validatebox:
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<script src="easyui1.2.4/jquery-1.6.min.js" type="text/javascript"></script>
<script src="easyui1.2.4/jquery.easyui.min.js" type="text/javascript"></script>
<!-- 自定義驗證 -->
<script src="easyui1.2.4/validator.js" type="text/javascript"></script>
<link href="easyui1.2.4/themes/default/easyui.css" rel="stylesheet" type="text/css" />
<script>
$(function () {
// 讓所有 text 類型輸入框具備驗證能力
$('input[type=text]').validatebox();
});
</script>
</head>
<body>
郵箱驗證:<input type="text" validtype="email" required="true"
missingMessage="不能為空" invalidMessage="郵箱格式不正確" /><br />
網址驗證:<input type="text" validtype="url"
invalidMessage="url格式不正確[https://www.example.com]" /><br />
長度驗證:<input type="text" validtype="length[8,20]"
invalidMessage="有效長度8-20" /><br />
手機驗證:<input type="text" validtype="mobile" /><br />
郵編驗證:<input type="text" validtype="zipcode" /><br />
賬號驗證:<input type="text" validtype="account[8,20]" /><br />
漢字驗證:<input type="text" validtype="CHS" /><br />
遠程驗證:<input type="text" validtype="remote['checkname.aspx','name']"
invalidMessage="用戶名已存在" />
</body>
</html>
幾個常用屬性的分工值得記住:required 控制必填,missingMessage 是「未填寫」時的提示,invalidMessage 則是「格式不符」時的提示。方括號內的參數會作為第二個引數傳給驗證函數。
EasyUI 把內建規則掛在 $.fn.validatebox.defaults.rules 上,直接擴充這個物件即可註冊新規則。每條規則包含一個 validator 函數(回傳 boolean)與一個 message:
// validator.js —— 擴充 EasyUI 表單驗證規則
$.extend($.fn.validatebox.defaults.rules, {
// 漢字驗證
CHS: {
validator: function (value) {
return /^[\u0391-\uFFE5]+$/.test(value);
},
message: '只能輸入漢字'
},
// 行動手機號碼驗證
mobile: {
// value 為文本框中的值
validator: function (value) {
var reg = /^1[3|4|5|8|9]\d{9}$/;
return reg.test(value);
},
message: '輸入手機號碼格式不准確.'
},
// 國內郵編驗證
zipcode: {
validator: function (value) {
var reg = /^[1-9]\d{5}$/;
return reg.test(value);
},
message: '郵編必須是非 0 開始的 6 位數字.'
},
// 用戶賬號驗證(只能包含 _ 、數字、字母)
account: {
// param 的值即為 [] 中的內容
validator: function (value, param) {
if (value.length < param[0] || value.length > param[1]) {
$.fn.validatebox.defaults.rules.account.message =
'用戶名長度必須在' + param[0] + '至' + param[1] + '範圍';
return false;
}
if (!/^[\w]+$/.test(value)) {
$.fn.validatebox.defaults.rules.account.message =
'用戶名只能由數字、字母、下劃線組成.';
return false;
}
return true;
},
message: ''
}
});
要點說明:
validtype="account[8,20]" 時,[8,20] 會以陣列形式作為 validator 的第二個引數傳入。validator 內部改寫規則的 message,可以依實際失敗原因給出不同提示,比單一靜態訊息友善得多。remote['checkname.aspx','name'] 會把欄位值送到後端檢查(例如帳號是否已註冊),適合唯一性這類無法在前端判斷的規則。實作時建議把自定義規則集中放在獨立檔案中,與頁面結構分離;同時留意正則的邊界條件(例如手機號第二段用 [3|4|5|8|9] 時,| 在字元 group 內其實是字面量,嚴格來說應寫成 [345789]),避免規則看似生效卻在特定號段上失效。