表單驗證是後台系統的必備功能。這份範例以 EasyUI 的 validatebox 為基礎,搭配自訂的 validator.js,就能用宣告式屬性完成帳號、身分證字號、手機、電子郵件等各式檢查。

<link href="../Scripts/themes/default/easyui.css" rel="stylesheet" type="text/css" />
<script src="../Scripts/jquery-1.4.1.min.js" type="text/javascript"></script>
<script src="../Scripts/jquery.easyui.min.js" type="text/javascript"></script>
<script src="../Scripts/validator.js" type="text/javascript"></script>
<script src="../Scripts/locale/easyui-lang-zh_CN.js" type="text/javascript"></script>
其中 validator.js 是自行擴充的驗證規則檔,用來註冊 account、CHS、idcard、QQ、mobile、phone、ZIP 等規則。
$(function () {
// 逐一掛上驗證:只要有 required 或 validType 就啟用
$('#uiform input').each(function () {
if ($(this).attr('required') || $(this).attr('validType')) {
$(this).validatebox();
}
});
$("#btn").click(function () {
var flag = $("#uiform").form("validate");
if (flag) {
$("#uiform").form("destroy");
alert('驗證通過!');
}
});
});
$('#ajax_test2').click(function () {
$.ajax({
url: "../Handler1.ashx?Menthod=Login",
type: 'post',
data: { name: "123456" },
timeout: 30000,
beforeSend: function (XMLHttpRequest) {
$("#loading").html("<img src='../Scripts/loader.gif' />");
},
success: function (data, textStatus) {
alert('開始回調,狀態文本值:' + textStatus + ' 返回數據:' + data);
$("#loading").empty();
},
complete: function (XMLHttpRequest, textStatus) {
alert('遠程調用成功,狀態文本值:' + textStatus);
$("#loading").empty();
},
error: function (XMLHttpRequest, textStatus, errorThrown) {
alert('error...狀態文本值:' + textStatus + " 異常信息:" + errorThrown);
$("#loading").empty();
}
});
});
驗證規則全部寫在 HTML 屬性上,後端與 JavaScript 都不用再寫一次:
<form id="uiform" title="表單驗證頁面" class="easyui-window">
<table>
<tr>
<td>登錄名:</td>
<td><input required="true" id="txtUsername" type="text"
validType="account[4,20]" /></td>
<td>真實姓名:</td>
<td><input id="txtTruename" validType="CHS" required="true" type="text" /></td>
</tr>
<tr>
<td>登錄密碼:</td>
<td><input validType="password" required="true" id="txtPassword"
name="password" type="password" /></td>
<td>Email:</td>
<td><input id="txtEmail" name="email" validType="email" type="text" /></td>
</tr>
<tr>
<td>身份證號:</td>
<td><input validType="idcard" id="txtIdcard" name="idcard" type="text" /></td>
<td>QQ:</td>
<td><input validType="QQ" id="txtQq" name="qq" type="text" /></td>
</tr>
<tr>
<td>手機:</td>
<td><input validType="mobile" id="txtMobile" name="mobile" type="text" /></td>
<td>電話:</td>
<td><input id="txtTel" validType="phone" name="tel" type="text" /></td>
</tr>
<tr>
<td>郵編:</td>
<td><input validType="ZIP" id="txtZIP" name="txtZIP" type="text" /></td>
<td>年齡:</td>
<td><input validType="number" id="txtAge" name="txtAge" type="text" /></td>
</tr>
<tr>
<td>備注:</td>
<td colspan="3">
<input type="text" class="easyui-validatebox" required="true"
validType="minLength[50]" id="txtRemark" />
</td>
</tr>
<tr>
<td>text</td>
<td colspan="3">
<input id="name" type="text" class="easyui-validatebox"
missingMessage="當文本框是空時出現的提示文字。"
invalidMessage="當文本框的內容無效時出現的提示文字"
required="true" validType="minLength[5]" />
</td>
</tr>
<tr>
<td>文本框比對:</td>
<td colspan="3">
<input type="password" id="txtpasswd" class="easyui-validatebox"
required="true" validType="password" />
<input type="password" id="txtpasswd2" class="easyui-validatebox"
required="true" validType="equalTo['#txtpasswd']" />
</td>
</tr>
</table>
<hr />
<input id="btn" type="button" value="submit" />
<input id="ajax_test2" type="button" value="ajax_test2" />
<div id="loading"></div>
</form>
required="true":必填,未填時顯示 missingMessage。validType="email"/"number":格式檢查。validType="minLength[5]":最小長度。validType="equalTo['#txtpasswd']":與另一欄位比對,常用於密碼確認。validType="account[4,20]":自訂規則,可帶參數指定長度區間。把規則寫在標記上、把訊息交給框架顯示,是這套做法最省心的地方;若日後要新增欄位,只要補上屬性即可,不必回頭改 JavaScript。