DIV CSS 佈局教程網

用 jQuery 的 ajaxSubmit() 無刷新提交表單
編輯:JQuery特效代碼     

傳統的表單提交會讓頁面跳轉到 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 之後就不會了。

三、以 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;        // 阻止表單預設的跳轉行為
    });
});

實際上只需要 ajaxSubmit 就夠了

範例在外層多包了一個 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 狀態碼判斷,是這類表單最常見的誤解。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved