用 EasyUI 的 form 方法做 AJAX 表單提交,比傳統的頁面跳轉多了幾個環節:送出前驗證、送出中提示、成功後刷新列表並關閉視窗、失敗時顯示原因。以下是一段可直接參考的結構。
$('#form').form({
url: 'test/add.do',
onSubmit: function () {
parent.$.messager.progress({
title: '提示',
text : '數據處理中,請稍後....'
});
var gridValid = endEdit(); // 子表結束編輯並驗證
if (!gridValid) {
parent.$.messager.progress('close');
return false; // 回傳 false 可中止送出
}
var isValid = $('#form').form('validate');
if (!isValid) {
parent.$.messager.progress('close');
return false;
}
accept(); // 把子表增刪改的資料寫進隱藏 input
return true;
},
success: function (result) {
parent.$.messager.progress('close');
try {
var data = eval("(" + result + ")"); // JSON 字串轉物件
if (data && data.success) {
if (data.msg && data.msg != "")
parent.$.messager.alert('提示', data.msg);
else
parent.$.messager.alert('提示', "添加成功");
parent.$.modalDialog.openner_grid.datagrid('reload'); // 刷新列表
parent.$.modalDialog.handler.dialog('close'); // 關閉目前視窗
} else {
parent.$.messager.alert('錯誤', data.msg);
}
} catch (e) {
parent.$.errorDialog(result); // 伺服器回傳非 JSON,視為異常
}
}
});
onSubmit 回傳 false 即中止。這是 EasyUI 的設計:表單會在送出前呼叫 onSubmit,若回傳 false 就不發請求。因此所有前置檢查都放在這裡,任一項失敗就關掉進度提示並回傳 false。
進度提示要記得關。程式中每個 return false 之前都呼叫了 progress('close')。若漏掉,遮罩會永遠卡在畫面上,使用者只能重新整理。這是最常見的疏失。
success 中必須 try/catch。eval 解析字串時,若伺服器因例外而回傳 HTML 錯誤頁,就會拋出語法錯誤。用 try/catch 攔下並導向錯誤提示,能避免「按了沒反應」的窘境。
成功後 reload 列表並關閉視窗。順序上先刷新再關閉比較安全——若顛倒,reload 可能作用在一個已被移除的 grid 上。
eval 應改為 JSON.parse。eval("(" + result + ")") 是早期為相容舊瀏覽器而生的寫法,但它會執行字串中的任意程式碼。伺服器回傳的內容一旦被污染,就是一個 XSS 入口。請直接改用:
var data = JSON.parse(result);
回傳格式要約定好。建議後端在錯誤時也回傳 JSON(例如 {"success": false, "msg": "..."}),並設定適當的 HTTP 狀態碼;如此前端就不必靠「解析失敗」來推測發生了什麼,錯誤處理會乾淨很多。
重複送出防護。使用者連點兩下送出按鈕,可能建立兩筆資料。可在 onSubmit 中立刻停用送出鈕,並在 success/error 中恢復:
var $btn = parent.$('#saveBtn');
$btn.prop('disabled', true);
// 於 success 與 error 的收尾處
$btn.prop('disabled', false);
error 回呼。目前只處理 success。網路中斷時表單會停在 loading 狀態,應補上:
error: function (xhr, status, err) {
parent.$.messager.progress('close');
parent.$.messager.alert('錯誤', '網路異常,請稍後再試');
}
把這些收尾細節補齊,表單提交才算真正可靠——多數「表單偶爾壞掉」的線上事故,都是卡在這幾個未處理的分支上。