傳統表單提交會讓整個頁面刷新,使用者得等白屏、再重新找回原本的位置。改用 AJAX 非同步提交後,資料在背景傳送,頁面其餘部分完全不受影響,體驗好上許多。以下是一段可直接套用的實作。
$.ajax({
url: "mobileSurveyAction_addSurvey.action", // 提交位址
data: $("#form1").serialize(), // 將表單資料序列化
type: "POST",
dataType: "json",
success: function(result){
if (result.success == '100'){
$("#mySection").hide();
$(".footer").hide();
$("#alertMsg").show();
} else {
alert("失敗!");
}
}
});
$("#form1").serialize() 會把表單內容編碼成 URL query string 格式,例如 name=John&age=20&city=Taipei,剛好符合 $.ajax 的 data 參數格式。它會自動處理 URL 編碼,也能正確排除未勾選的 checkbox 與 disabled 欄位,比自己手動拼字串安全得多。
相關的還有 serializeArray(),它回傳的是陣列形式,適合需要逐項處理的情況:
var arr = $("#form1").serializeArray(); // [{name:"a", value:"1"}, ...]
jQuery 另外提供了 .submit() 事件與更直覺的寫法,可以省下不少樣板:
$("#form1").on("submit", function(e){
e.preventDefault(); // 阻止表單的預設送出
$.post("api/survey", $(this).serialize(), function(res){
if(res.code === 0){
$("#form1")[0].reset();
$("#alertMsg").show();
}
}, "json");
});
注意這裡一定要 e.preventDefault(),否則 AJAX 送出後瀏覽器仍會執行原本的表單提交,導致頁面跳走。
範例只寫了 success,但網路不穩、伺服器 500、逾時都可能發生。完整的寫法應該補上 error:
$.ajax({
url: "api/survey",
type: "POST",
data: $("#form1").serialize(),
dataType: "json",
timeout: 10000,
success: function(res){ /* ... */ },
error: function(xhr, status, err){
console.error(status, err);
$("#alertMsg").text("網路異常,請稍後再試").show();
}
});
disabled 並顯示 loading 狀態,避免使用者重複送出建立多筆資料。fetch() 搭配 FormData 可以完成同樣的事,且原生支援 Promise。