DIV CSS 佈局教程網

jQuery 一次提交多個表單:做法、陷阱與更好的替代方案
編輯:JQuery特效代碼     

有些介面確實需要把兩份獨立的表單一起送出,例如「基本資料」與「偏好設定」分屬兩個 form,卻共用一顆儲存鈕。以下是最直白的實作。

基本寫法

<script type="text/javascript">
$(function () {
    $("#btnSubmit").click(function () {
        $("form[name='form1']").submit();
        $("form[name='form2']").submit();
    });
});
</script>

<form name="form1" action="handleForm1Action"></form>
<form name="form2" action="handleForm2Action"></form>
<button id="btnSubmit">提交</button>

這個做法會出什麼事

關鍵問題在於:.submit() 會觸發真正的頁面導向。第一行送出後,瀏覽器開始導向 handleForm1Action;第二行雖然被執行,但頁面已在跳轉途中,那個請求很可能被取消,或形成非預期的競態。

實測上你可能會看到:只有第一個表單成功送出、兩個都送出但只有一個的結果被保留、或偶爾成功偶爾失敗(取決於網路速度與瀏覽器)。這種「大部分時候好像可以」的行為,是最難除錯的一類問題。

另外還有兩個次要問題:那顆 <button> 沒有 type 屬性,在表單外雖無妨,但若頁面結構稍作調整就可能變成 submit 鈕而觸發非預期行為;以及原範例的 <button>提交<button> 結尾標籤少了斜線。

正確做法一:用 Ajax 分別送出

既然要避免頁面跳轉,就用 Ajax 讓兩個請求各自完成:

$("#btnSubmit").on("click", function () {
    var $btn = $(this).prop("disabled", true);

    $.when(
        $.post("handleForm1Action", $("form[name='form1']").serialize()),
        $.post("handleForm2Action", $("form[name='form2']").serialize())
    ).done(function (res1, res2) {
        // 兩者都成功
        console.log(res1[0], res2[0]);
    }).fail(function () {
        alert("儲存失敗,請重試");
    }).always(function () {
        $btn.prop("disabled", false);
    });
});

$.when() 會等到所有傳入的 deferred 都完成才觸發 done,這正是「等兩件事都做完」的語意。用 async/await 寫更直觀:

$("#btnSubmit").on("click", async function () {
    var $btn = $(this).prop("disabled", true);
    try {
        await Promise.all([
            fetch("handleForm1Action", { method: "POST", body: new FormData(form1) }),
            fetch("handleForm2Action", { method: "POST", body: new FormData(form2) })
        ]);
        location.href = "/success";
    } catch (err) {
        alert("儲存失敗,請重試");
    } finally {
        $btn.prop("disabled", false);
    }
});

但要注意:兩個獨立請求意味著沒有交易(transaction)保障。若第一個成功、第二個失敗,你會處於半完成的狀態。這類需求通常該由後端提供一個「一次收兩份資料」的 API,在單一交易中處理,失敗則全部回滾。

正確做法二:合併為一個表單

這其實是最該優先考慮的方案。HTML 表單的目的是「把一群欄位一起送出」,若它們的送出去向與時機相同,就沒有理由分成兩個。

<form id="profileForm" action="handleSubmit" method="post">
  <fieldset>
    <legend>基本資料</legend>
    <input name="username">
    <input name="email">
  </fieldset>

  <fieldset>
    <legend>偏好設定</legend>
    <input name="theme">
    <input name="lang">
  </fieldset>

  <button type="submit">儲存</button>
</form>

用 <fieldset> 與 <legend> 做視覺與語意的分區,就能得到「兩個區塊、一次送出」的效果,而且完全不必寫 JavaScript。同時還免費獲得:Enter 鍵送出、瀏覽器自動填寫、原生表單驗證、以及無障礙軟體的正確朗讀。

如果確實必須分開送出

有些情境真的無法合併——例如兩個表單的 action 不同、分屬不同的服務或不同的 content type。此時的建議:

  • 用 Ajax 序列化送出,不要依賴 .submit()。
  • 後端最好提供一個聚合端點,由它去呼叫兩邊並處理一致性。
  • 若兩個請求有先後依賴(例如第二個需要第一個產生的 id),用 await 串行而非 $.when() 並行。
  • 為整組操作加上 loading 狀態與防重複送出,避免使用者連點造成重複建立資料。

最後提醒:用 $("form[name='form1']") 這種寫法能運作,但屬性選擇器的效能與可讀性都不如 id。給表單加上 id 並用 $("#form1"),是更值得維持的習慣。

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