萬盛學電腦網

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

jQuery 表單序列化為物件:serializeArray() 進階應用

基礎:serialize() vs serializeArray()

方法回傳格式適用場景
.serialize()URL 編碼字串 a=1&b=2直接作為 AJAX data 發送
.serializeArray()陣列物件 [{name:'a',value:'1'},...]前端處理、轉物件、驗證

核心需求:轉為 { key: value } 物件

/**
 * 將表單序列化為純物件 { name: value }
 * 同名欄位以逗號合併(如 checkbox 群組)
 * @param {jQuery|Element} form
 * @returns {Object}
 */
function formToObject(form) {
  var $form = $(form);
  var obj = {};
  
  $.each($form.serializeArray(), function(index, field) {
    var name = field.name;
    var value = field.value;
    
    if (obj[name] !== undefined) {
      // 同名欄位:陣列化或逗號合併
      if (!Array.isArray(obj[name])) {
        obj[name] = [obj[name]];
      }
      obj[name].push(value);
      // 或:obj[name] = obj[name] + ',' + value;
    } else {
      obj[name] = value;
    }
  });
  
  return obj;
}

// 使用
var formData = formToObject('#myForm');
console.log(formData);
// { username: 'john', roles: ['admin', 'user'], email: 'john@test.com' }

進階版:支援巢狀物件(name="user[name]")

/**
 * 支援點號/中括號命名法的深度序列化
 * name="user.name" → { user: { name: '...' } }
 * name="items[0].id" → { items: [{ id: '...' }] }
 */
function formToObjectDeep(form) {
  var $form = $(form);
  var obj = {};
  
  $.each($form.serializeArray(), function(_, field) {
    setDeepValue(obj, field.name, field.value);
  });
  
  return obj;
}

function setDeepValue(obj, path, value) {
  // 簡易實作:支援 a.b.c 格式
  var keys = path.replace(/\[(\d+)\]/g, '.$1').split('.');  // items[0].id → items.0.id
  var current = obj;
  
  for (var i = 0; i < keys.length - 1; i++) {
    var key = keys[i];
    var nextKey = keys[i + 1];
    var isArrayIndex = /^\d+$/.test(nextKey);
    
    if (!(key in current)) {
      current[key] = isArrayIndex ? [] : {};
    }
    current = current[key];
  }
  
  var lastKey = keys[keys.length - 1];
  if (Array.isArray(current) && /^\d+$/.test(lastKey)) {
    current[parseInt(lastKey)] = value;
  } else {
    // 同名處理
    if (current[lastKey] !== undefined) {
      if (!Array.isArray(current[lastKey])) {
        current[lastKey] = [current[lastKey]];
      }
      current[lastKey].push(value);
    } else {
      current[lastKey] = value;
    }
  }
}

實戰:表單資料預覽與提交

$('#previewBtn').click(function() {
  var data = formToObject('#myForm');
  $('#preview').text(JSON.stringify(data, null, 2));
});

$('#submitBtn').click(function() {
  var data = formToObjectDeep('#myForm');
  
  $.ajax({
    url: '/api/submit',
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify(data),
    success: function(res) {
      alert('提交成功');
    }
  });
});

常見坑點

  • disabled 欄位不會被序列化 → 用 readonly 替代或手動補充
  • 未勾選的 checkbox/radio 不會出現在結果中 → 需要時手動添加預設值
  • file 輸入框無法序列化 → 檔案上傳需用 FormData
  • 按鈕 type="submit" 也會被序列化 → 給按鈕加 name 時注意

現代原生替代:FormData

var form = document.getElementById('myForm');
var formData = new FormData(form);

// 轉物件
var obj = {};
for (var pair of formData.entries()) {
  // 同名處理邏輯同前
  if (obj[pair[0]]) {
    if (!Array.isArray(obj[pair[0]])) obj[pair[0]] = [obj[pair[0]]];
    obj[pair[0]].push(pair[1]);
  } else {
    obj[pair[0]] = pair[1];
  }
}

// 直接發送(支援檔案)
fetch('/api/upload', { method: 'POST', body: formData });

總結

  • serializeArray() 取得結構化陣列,易於前端處理
  • 封裝 formToObject() 統一專案表單資料格式
  • 複雜巢狀結構用 name="a.b.c" 慣例 + 深度解析函數
  • 現代專案優先 FormData,支援檔案、無需 jQuery
copyright © 萬盛學電腦網 all rights reserved