一般的表單提交寫法如下:
<form action="saveReport.htm" method="post">
……
<input type="submit" value="保存報告"/>
</form>
點擊 submit 或直接按 Enter,資料會送到 saveReport 頁面,同時瀏覽器也會跳轉過去。但在很多情境下——特別是「載入某個頁面的同時順便存一份資料」——我們要的是資料送出去、畫面留在原地。
<form id="saveReportForm" action="saveReport.htm" method="post" onsubmit="return saveReport();">
<input type="submit" value="保存報告"/>
</form>
表單加上 id 供 jQuery 選取,再加上 onsubmit 指向自訂函式,把提交的控制權接過來:
function saveReport() {
// jquery 表單提交
$("#saveReportForm").ajaxSubmit(function(message) {
// 表單提交成功後的處理,message 為 saveReport.htm 的返回內容
});
return false; // 必須返回 false,否則表單會自己再做一次提交並且跳轉
}
return false 不能省。onsubmit 回傳 false 才會取消瀏覽器的預設提交行為。少了它,資料會被送兩次:一次由 ajaxSubmit、一次由原生的 form submit,畫面也跟著跳走。
ajaxSubmit 來自 jquery.form 插件。它會自動序列化整個表單(包含 file 欄位),比手動 $.post($("#form").serialize()) 更方便,也支援 type: "file" 的檔案上傳。若不想引入插件,可用:
$("#saveReportForm").submit(function(e){
e.preventDefault();
$.post("saveReport.htm", $(this).serialize(), function(message){
// 處理回應
});
});
另外提醒:原文範例中表單 id 是 saveReportForm,而 ajaxSubmit 卻選了 #showDataForm,兩者不一致會導致完全沒有作用——這類複製貼上造成的 id 錯位相當常見,除錯時值得優先檢查。若表單中含有必填欄位,也記得在送出前自己跑一次驗證,因為 ajaxSubmit 不會幫你擋。