DIV CSS 佈局教程網

jQuery 表單提交與序列化:從 form() 到 serialize() 的演進
編輯:JavaScript綜合知識     

表單提交有各種層次的做法,從完整交給框架,到逐欄取值,再到一行序列化。本文按演進順序整理,並說明每種方式的適用時機。

第一階段:用 form() 把提交事件從按鈕解耦

傳統表單的提交綁在 submit 按鈕上。透過 easyUI 的 form() 方法,可以把它綁到任何事件上,並在其中插入驗證與回饋邏輯:

function addSubmit() {
  $('#addForm').form('submit', {
    url: _basePath + '/@Controller/@RequestMapping',
    onSubmit: function () {
      if (boolean) {   // 放置能否提交的判斷條件
        $.messager.show({
          title: '提示', msg: '不符合保存條件',
          showType: 'fade', style: { right: '', bottom: '' }
        });
        return false;   // 回傳 false 阻止表單提交
      }
      return $('#addForm').form('validate');  // 檢查 required 項是否都有值
    },
    success: function (data) {
      var obj = jQuery.parseJSON(data);   // 將回傳的 JSON 轉為物件
      if (!obj.success) {
        $.messager.show({
          title: '提示', msg: '保存失敗',
          showType: 'fade', style: { right: '', bottom: '' }
        });
      } else {
        $.messager.show({
          title: '提示', msg: '保存成功',
          showType: 'fade', style: { right: '', bottom: '' }
        });
        $("#addWin").window("close");   // 關閉視窗
        query();                        // 重新查詢結果集
      }
    }
  });
}

這個版本的優點是驗證、提示、關閉視窗、刷新列表全部包在一個設定物件裡,結構清楚。缺點是與 easyUI 深度耦合。

第二階段:手動逐欄取值

不用框架時,最直接的做法是從各欄位一一取值再組合成物件:

$("#btn").click(function () {
  $.get("get.php", {
    username: $("#username").val(),
    password: $("#password").val()
  }, function (data, textStatus) {
    $("#target").html(data);   // 將回傳值填入頁面
  });
});

這種寫法清楚可控,但欄位一多就會變成長長一串,新增欄位時也容易漏改。

第三階段:用 serialize() 序列化

$("#btn").click(function () {
  $.get("get.php", $("#form").serialize(), function (data, textStatus) {
    $("#target").html(data);
  });
});

serialize() 會把表單內容打包成 URL 查詢字串格式的標準字串,例如 username=amosli&age=30。它會自動進行 URL 編碼,處理特殊字元的問題;而且不限於表單元素,checkbox 等其他可提交元素也能正確處理。

第四階段:serializeArray() 取得結構化資料

serializeArray() 回傳的是陣列形式的物件,而非 JSON 字串:

var data = $("#form").serializeArray();
// [{ name: "username", value: "amosli" }, { name: "age", value: "30" }]

$.each(data, function (i, item) {
  console.log(item.name + " = " + item.value);
});

因為回傳的已是真正的 JavaScript 物件,不必再呼叫 jQuery.parseJSON() 轉換,可以直接用 $.each() 等方法操作。若你需要對欄位做額外處理(例如過濾某些欄位、轉換值格式),這個形式比字串方便得多。

serialize() 的限制

這個方法並非萬能,有幾個情況要注意:

只序列化成功的控制項。依 HTML 規範,未勾選的 checkbox 與 radio 不會被序列化、被 disabled 的欄位不會被序列化、沒有 name 屬性的欄位也不會。若後端需要收到「未勾選」的狀態,得另外處理。

file 上傳欄位不在其中。 serialize 產生的是字串,無法承載檔案,上傳必須改用 FormData。

jQuery 3.x 移除了部分舊語法。像 [@attr] 這種選擇器寫法已不適用,若維護舊程式碼需留意。

現代寫法建議

如今比較通用的做法有兩種。若只是要 traditional form-urlencoded 格式:

$("#btn").click(function (e) {
  e.preventDefault();
  $.ajax({
    url: "get.php",
    type: "POST",
    data: $("#form").serialize(),
    dataType: "json",
    success: function (res) {
      $("#target").html(res.message);
    },
    error: function () {
      alert("網路異常,請稍後再試");
    }
  });
});

若需要支援檔案上傳,改用 FormData:

$("#btn").click(function (e) {
  e.preventDefault();
  var formData = new FormData(document.getElementById('myForm'));
  $.ajax({
    url: "upload.php",
    type: "POST",
    data: formData,
    processData: false,   // 關鍵:不要讓 jQuery 加工資料
    contentType: false,   // 關鍵:讓瀏覽器自動設定 multipart boundary
    success: function (res) { console.log(res); }
  });
});

processData: false 與 contentType: false 這兩個設定缺一不可。少了前者,jQuery 會把 FormData 轉成字串而失去檔案;少了後者,boundary 分隔符號會不正確而導致伺服器無法解析。

搭配 fetch 的寫法

document.getElementById('myForm').addEventListener('submit', async function (e) {
  e.preventDefault();
  const formData = new FormData(this);

  // 轉成普通物件(不含檔案時)
  const payload = Object.fromEntries(formData.entries());

  try {
    const res = await fetch('/api/save', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(payload)
    });
    if (!res.ok) throw new Error(res.statusText);
    const data = await res.json();
    console.log(data);
  } catch (err) {
    console.error('送出失敗:', err);
  }
});

FormData 搭配 Object.fromEntries() 可以取代 serialize 的大部分用途,而且不依賴任何函式庫。若需要 JSON 格式給 RESTful API,這是最直接的寫法。

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