兩種模式本質區別
| 特性 | 手動構造 URL/Data | 表單序列化提交 |
| 資料來源 | JS 變數、使用者輸入、計算結果 | DOM ` |
| 適用場景 | 簡單參數、RESTful API、非表單觸發 (如按鈕、定時輪詢) | 複雜表單、用戶註冊、編輯頁、檔案上傳 |
| 維護性 | 參數散落各處,易遺漏/拼錯 | 單一來源真理 (表單 DOM),新增欄位自動包含 |
| 驗證整合 | 需手動呼叫驗證函式 | 可直接整合 HTML5 驗證 / jQuery Validation |
| 檔案支援 | 需手動構造 FormData | 原生支援 (配合 FormData 或 iframe) |
模式一:手動構造 URL 參數 (jQuery $.ajax)
function createHtml(id) {
$('#loading').show();
$('#mask').show();
$.ajax({
type: 'POST',
url: 'pageAction!createHtml.action',
data: { id: id }, // 物件自動序列化為 "id=123"
dataType: 'json',
success: function(res) {
$('#loading').hide();
$('#mask').hide();
if (res.success) alert('操作成功');
else alert('失敗:' + res.msg);
},
error: function(xhr) {
$('#loading').hide();
$('#mask').hide();
alert('網路錯誤:' + xhr.statusText);
}
});
}
模式二:表單序列化提交 (需 jquery.form.js)
<form id="form1" action="costAction!save2.action" method="post">
<input name="name" required>
<input name="email" type="email" required>
<textarea name="desc"></textarea>
<input type="file" name="attach">
<button type="submit">儲存</button>
</form>
<script>
$('#form1').ajaxForm({
dataType: 'json',
beforeSubmit: function(arr, $form, opts) {
// arr = [{name:'name',value:'...'}, ...] 可做最後驗證
return $form[0].checkValidity(); // HTML5 原生驗證
},
success: function(res, status, xhr, $form) {
if (res.success) {
alert('儲存成功');
location.reload();
} else {
alert('業務錯誤:' + res.msg);
}
},
error: function(xhr) {
alert('提交失敗:' + xhr.statusText);
}
});
</script>
進階:統一錯誤處理與回應格式規範
// 後端統一回應格式
public class AjaxResult {
boolean success;
String code; // 業務錯誤碼:PARAM_EMPTY, TIME_CONFLICT, NO_PERMISSION...
String message; // 使用者可讀訊息
Object data; // 成功時回傳資料
}
// 前端統一攔截 (jQuery ajaxSetup 或 axios 攔截器)
$.ajaxSetup({
dataType: 'json',
error: function(xhr) {
var msg = '系統異常';
if (xhr.responseJSON) msg = xhr.responseJSON.message;
else if (xhr.status === 0) msg = '網路不通';
else if (xhr.status === 401) { location.href = '/login'; return; }
else if (xhr.status >= 500) msg = '伺服器錯誤';
showToast(msg);
},
complete: function() { hideLoading(); }
});
常見坑點與解法
- 表單提交後回調拿不到資料 / data 為整頁 HTML
- 原因:`
- 檔案上傳失敗 / $_FILES 為空
- 原因:`$.ajax` 預設 `processData: true` 會將 FormData 序列化為字串。解法:`processData: false, contentType: false` 並傳入 `FormData` 物件;或改用 `ajaxForm` (jquery.form.js 內部自動處理)。
- 重複提交
- 解法:提交前 `btn.disabled = true`、顯示 Loading、請求完成再啟用;或用 Token 機制 (後端生成一次性 Token,表單隱藏域攜帶)。
選型決策樹
需要上傳檔案?
├─ 是 → 目標瀏覽器 ≥ IE10? → 是 → FormData + fetch/$.ajax (processData:false)
│ └─ 否 → 隱藏 Form + Iframe (jquery.form.js)
└─ 否 → 資料來自表單? → 是 → $('#form').ajaxForm() / new FormData(form)
└─ 否 → 簡單參數 → $.ajax({data:{...}})