EasyUI 是基於 jQuery 的經典 UI 庫,其表單驗證功能(validatebox)聲明式、易用、支援內置/自定義驗證規則。本文展示完整表單結構、驗證規則配置、AJAX 提交流程與常見問題處理。
HTML 表單結構
<form id="myForm" method="post">
<table align="center" style="width:400px;margin-top:20px;">
<tr>
<td align="right">命令:</td>
<td>
<input id="cmd" name="cmd" style="width:200px;"
class="easyui-validatebox"
required="true"
validType="length[5,12]"
missingMessage="不能為空" />
</td>
</tr>
<tr>
<td align="right">描述:</td>
<td>
<input id="depict" name="depict" style="width:200px;"
class="easyui-validatebox"
required="true"
validType="length[5,12]"
missingMessage="不能為空" />
</td>
</tr>
<tr>
<td align="right">類型:</td>
<td>
<input id="type" style="width:200px"
class="easyui-combobox"
url="data/editHealthCheckCombobox_data.json"
valueField="id" textField="text" />
</td>
</tr>
<tr>
<td align="right">分數:</td>
<td>
<input id="score" name="score" style="width:200px" class="easyui-numberspinner" />
</td>
</tr>
<tr>
<td align="right">使用狀況:</td>
<td>
<input id="isUse" style="width:200px" class="easyui-validatebox" />
</td>
</tr>
<tr>
<td align="center" colspan="2">
<input type="submit" value="提交" />
<input type="reset" value="重置" />
</td>
</tr>
</table>
</form>
核心驗證屬性解析
| 屬性 | 作用 | 示例 |
class="easyui-validatebox" | 啟用驗證框組件 | 必須 |
required="true" | 必填項 | 空值時顯示 missingMessage |
missingMessage | 為空時的提示文本 | "不能為空" |
validType | 驗證類型 | "email"、"length[5,12]"、"remote['url', 'param']" |
invalidMessage | 格式錯誤時提示 | "格式不正確" |
內置驗證類型 (validType)
// 常用內置類型
'email' // 郵箱格式
'url' // URL 格式
'length[0,100]' // 長度範圍
'remote[url,param]' // 遠程驗證(AJAX)
'equals[#fieldId]' // 與某字段值相等(如確認密碼)
AJAX 提交核心代碼
$('#myForm').form({
url: '/ProcessServlet', // 提交地址
onSubmit: function() {
// 1. 觸發驗證,返回 false 阻止提交
return $(this).form('validate');
},
success: function(data) {
// 2. 服務端返回處理
// data 為字串,若返回 JSON 需手動解析
try {
var result = JSON.parse(data);
if (result.success) {
$.messager.alert('成功', '保存成功!', 'info');
} else {
$.messager.alert('失敗', result.msg || '保存失敗', 'error');
}
} catch (e) {
alert(data); // 非 JSON 直接彈窗
}
},
onLoadError: function() {
$.messager.alert('錯誤', '請求失敗,請檢查網絡', 'error');
}
});
關鍵 API 詳解
// 1. 手動觸發驗證
$('#myForm').form('validate'); // 返回 true/false
// 2. 獲取表單數據 (JSON 對象)
var data = $('#myForm').form('serialize'); // 序列化為字串
var dataObj = $('#myForm').form('serializeArray'); // 數組對象
// 3. 填充表單
$('#myForm').form('load', { cmd: 'test', depict: '描述' });
// 或從 URL 加載
$('#myForm').form('load', 'api/getData?id=1');
// 4. 重置表單
$('#myForm').form('clear'); // 清空值
$('#myForm').form('reset'); // 重置為初始值
// 5. 動態添加/移除驗證規則
$('#cmd').validatebox({
required: true,
validType: 'length[3,20]'
});
$('#cmd').validatebox('remove'); // 移除驗證
自定義驗證規則擴展
$.extend($.fn.validatebox.defaults.rules, {
// 手機號驗證
mobile: {
validator: function(value) {
return /^1[3-9]\d{9}$/.test(value);
},
message: '手機號格式不正確'
},
// 中文姓名
chineseName: {
validator: function(value) {
return /^[\u4e00-\u9fa5]{2,10}$/.test(value);
},
message: '請輸入 2-10 位中文姓名'
},
// 遠程驗證(如用戶名唯一性)
unique: {
validator: function(value, param) {
var result = false;
$.ajax({
url: param[0],
data: { value: value },
async: false, // 同步驗證
success: function(data) {
result = data.valid === true;
}
});
return result;
},
message: '該值已存在'
}
});
// 使用
<input class="easyui-validatebox" validType="mobile" />
<input class="easyui-validatebox" validType="unique['/api/check']" />
常見問題與解決
| 問題 | 原因 | 解決 |
| 驗證不生效 | 未引入 easyui.css / 類名拼寫錯誤 | 檢查引用、類名為 easyui-validatebox |
| 提交前不驗證 | 未在 onSubmit 返回 validate() | onSubmit: function(){ return $(this).form('validate'); } |
| Combobox 不驗證 | Combobox 隱藏原 input | 驗證隱藏的 input,或用 required 配合 panel 事件 |
| reset 不清除驗證提示 | EasyUI 不自動清除 | 手動調用 .validatebox('reset') |
現代替代方案
- Vue/React + VeeValidate / Formik / React Hook Form:聲明式、TypeScript 支援、生態豐富
- 原生 HTML5 驗證:
required、pattern、minlength、:valid/:invalid 偽類
- 輕量庫:
validator.js、zod(Schema 驗證)