萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 一鍵提交多個表單:串聯/並行提交與資料彙整實作

場景

  • 大型表單拆分為多個 `
    ` 區塊 (基本資料、地址、附件、確認)。
  • 使用者點「送出」一次性提交所有資料。
  • 後端單一 API 接收完整資料物件。

方案一:彙整資料 → 單一 AJAX 提交 (推薦,最乾淨)

<form id="form-basic">
    <input name="name" required> <input name="email">
</form>
<form id="form-address">
    <input name="city"> <input name="zip">
</form>
<form id="form-extra">
    <textarea name="remark"></textarea>
</form>
<button id="btnSubmitAll">送出全部</button>

<script>
$('#btnSubmitAll').click(() => {
    // 1. 合併所有表單資料
    const formData = {};
    $('form').each(function() {
        $(this).serializeArray().forEach(f => {
            // 同名欄位自動轉陣列
            if (formData[f.name]) {
                formData[f.name] = Array.isArray(formData[f.name])
                    ? [...formData[f.name], f.value]
                    : [formData[f.name], f.value];
            } else {
                formData[f.name] = f.value;
            }
        });
    });

    // 2. 單一 AJAX 提交
    $.ajax({
        url: '/api/profile/complete',
        type: 'POST',
        contentType: 'application/json',
        data: JSON.stringify(formData),
        success: res => alert('儲存成功'),
        error: (xhr) => alert('失敗: ' + xhr.responseText)
    });
});
</script>

方案二:原生表單提交 (傳統多 form submit)

<button id="btnSubmitAll">送出全部</button>

<script>
$('#btnSubmitAll').click(() => {
    // 依序 submit,瀏覽器會跳轉/重新整理,適合傳統非 SPA 頁面
    // 注意:第一個 submit 後頁面即卸載,後續不會執行!
    // 此寫法**實務上不可用**,僅示範原始文章錯誤寫法
    $('form[name="form1"]').submit();
    $('form[name="form2"]').submit(); // 永遠不會執行到
});

關鍵警示: 原文提供的「多個 form.submit() 串聯」在瀏覽器中**完全無效**——第一個 `submit()` 觸發導頁,後續代碼不會執行。請改用方案一 (AJAX 合併) 或方案三 (隱藏欄位合併)。

方案三:隱藏欄位合併 → 單一 Form 提交 (傳統頁面適用)

<form id="masterForm" action="/submit" method="POST">
    <!-- 區塊 1 -->
    <fieldset><legend>基本資料</legend>
        <input name="name" required> <input name="email">
    </fieldset>
    <!-- 區塊 2 -->
    <fieldset><legend>地址</legend>
        <input name="city"> <input name="zip">
    </fieldset>
    <button type="submit">送出</button>
</form>
  • **最簡單、最標準**:單一 `` 包裹所有欄位,語意正確、無 JS 相依、SEO 友善。
  • 視覺上用 `
    `、`
    `、CSS/JS 做分步顯示,提交時一次送出。

方案四:FormData + Append (含檔案上傳)

$('#btnSubmitAll').click(() => {
    const fd = new FormData();
    $('form').each(function() {
        new FormData(this).forEach((val, key) => fd.append(key, val));
    });
    // fd 現在包含所有表單欄位 + 檔案
    $.ajax({
        url: '/api/upload',
        type: 'POST',
        data: fd,
        processData: false,  // 必須 false,否則 jQuery 會序列化 FormData
        contentType: false,  // 讓瀏覽器自動設定 multipart boundary
        success: res => console.log(res)
    });
});

進階:分步驗證 + 最後合併提交 (Wizard 模式)

const steps = ['#step1', '#step2', '#step3'];
let current = 0;

function validateStep(stepSel) {
    // 使用 HTML5 原生驗證或 jquery-validation
    return $(stepSel)[0].checkValidity(); // 原生
}

$('#nextBtn').click(() => {
    if (!validateStep(steps[current])) return;
    $(steps[current]).hide();
    current++;
    $(steps[current]).show();
    updateNav();
});

$('#prevBtn').click(() => { /* 類似 */ });

$('#finalSubmit').click(() => {
    if (steps.slice(0, current+1).every(validateStep)) {
        // 全部驗證通過,合併提交 (方案一)
        submitAll();
    }
});

總結建議

場景推薦方案
SPA / 現代前後端分離方案一:JS 合併 JSON + AJAX
傳統 SSR / 無 JS 環境方案三:單一 Form + fieldset 分組
含檔案上傳方案四:FormData 合併 + AJAX
多步驟精靈方案一 + 分步驗證邏輯

拋棄「多個 form.submit() 串聯」這個無效寫法,根據架構選擇正確的資料彙整與提交策略,才能構建穩健的表單系統。

copyright © 萬盛學電腦網 all rights reserved