DIV CSS 佈局教程網

用 jQuery + AJAX 實作表單非同步提交
編輯:JavaScript綜合知識     

傳統表單提交會讓整個頁面刷新,使用者得等白屏、再重新找回原本的位置。改用 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("失敗!");
        }
    }
});

關鍵是 serialize()

$("#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 狀態,避免使用者重複送出建立多筆資料。
  • 前端驗證不等於後端驗證:必填、格式、長度都該在前端先擋一次以改善體驗,但伺服器端一定要再做一次真正的檢核。
  • JSONP 與跨來源:若 API 在不同網域,需由後端設定 CORS 標頭,或改用同源代理。
  • 現代替代方案:若不使用 jQuery,fetch() 搭配 FormData 可以完成同樣的事,且原生支援 Promise。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved