傳統的表單提交會讓頁面跳轉到 action 指定的位址。但很多時候我們希望「送出後留在原頁」,例如即時新增一筆資料並更新列表。此時可以用 ajaxSubmit(),它是 jquery.form.js 這個外掛提供的方法。
使用前必須先載入 jQuery 與 form 外掛,順序不可顛倒:
<script src="https://code.jquery.com/jquery-1.11.0.min.js"></script> <script src="https://malsup.github.io/jquery.form.js"></script>
<form> 標題:<input type="text" name="title" /><br /> 內容:<textarea name="content"></textarea><br /> <button>提交</button> </form>
這是一個普通的表單,直接提交會跳頁。加上 ajaxSubmit 之後就不會了。
$('button').on('click', function() {
$('form').on('submit', function() {
var title = $('input[name=title]').val(),
content = $('textarea').val();
$(this).ajaxSubmit({
type: 'post', // 提交方式
url: 'your url', // 提交位址
data: {
'title': title,
'content': content
},
success: function(data) { // data 通常為伺服器回傳的 json
alert('提交成功!');
}
});
$(this).resetForm(); // 送出後清空表單
return false; // 阻止表單預設的跳轉行為
});
});
範例在外層多包了一個 click 事件、又同時監聽 submit,顯得多餘,而且容易導致同一份表單被送出兩次。更精簡的寫法是直接攔截 submit:
$('form').on('submit', function(e){
e.preventDefault(); // 阻止跳轉
$(this).ajaxSubmit({
url: '/api/items',
type: 'post',
success: function(res){
console.log(res);
e.currentTarget.reset();
},
error: function(xhr){
alert('送出失敗,請稍後再試');
}
});
});
ajaxSubmit() 本身就會收集表單中所有具 name 的欄位,所以通常不需要再手動組 data 物件。範例中之所以另外傳 data,是為了示範這個選項可用;實務上讓外掛自行序列化才是它的主要價值,也能自動涵蓋核取方塊、多選、檔案上傳等複雜情況。
別忘了 error 處理。範例只寫了 success,一旦網路失敗或伺服器回 500,使用者不會收到任何提示,畫面只是安靜地什麼都沒發生。至少加上 error 回呼。
成功後的 UI 更新。真正好用的無刷新提交,成功後應該把新資料插入列表、或更新計數,而不只是跳一個 alert。這也是使用 ajaxSubmit 而非傳統提交的主要目的。
傳統提交的路徑不能省。以 JS 攔截只在 JavaScript 正常運作時有效。表單的 action 屬性仍應指向一個能正常處理的端點,作為後備;同時伺服器端要能區分「AJAX 請求」與「傳統提交」並回傳對應格式(JSON 或重新導向)。
成功訊息由伺服器決定。alert('提交成功!') 寫在 success 裡,但 HTTP 200 只代表請求抵達,不代表業務邏輯成功。若伺服器回傳 { success: false, message: "標題重複" },前端仍需判斷並顯示正確訊息。把成功與否完全交由 HTTP 狀態碼判斷,是這類表單最常見的誤解。