萬盛學電腦網

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

jQuery 表單序列化為對象:核心插件實現解析

jQuery 原生 serializeArray() 返回數組格式,實際開發中常需轉為鍵值對象。本文深度解析一款經典的 serializeObject 插件實現,處理同名字段自動轉數組的邏輯。

核心代碼實現

$.fn.serializeObject = function() {
  var o = {};
  var a = this.serializeArray(); // [{name: "key", value: "val"}, ...]
  
  $.each(a, function() {
    // 同名字段處理:首次遇到存值,再次遇到轉數組 push
    if (o[this.name]) {
      if (!o[this.name].push) {        // 非數組則包裝為數組
        o[this.name] = [o[this.name]];
      }
      o[this.name].push(this.value || '');
    } else {
      o[this.name] = this.value || ''; // 首次賦值
    }
  });
  
  return o;
};

關鍵邏輯解析

  1. serializeArray():將表單元素序列化為標準數組格式,每項含 name/value。
  2. 同名去重策略:checkbox、select multiple 等控件提交同名多值,插件自動合併為數組。
  3. 空值容錯:this.value || '' 防止 null/undefined 污染數據。

使用示例

<form id="userForm">
  <input name="username" value="ZhangSan">
  <input name="hobby" value="coding">
  <input name="hobby" value="reading">
</form>

var data = $("#userForm").serializeObject();
// 結果:{username: "ZhangSan", hobby: ["coding", "reading"]}

現代替代方案

原生 FormData 配合 Object.fromEntries() (ES2019) 可輕量替代:

const formData = new FormData(document.querySelector('#userForm'));
const obj = Object.fromEntries(formData.entries()); // 注意:同名鍵會被覆蓋,需額外處理

理解插件原理,有助於在無依賴環境下快速實現同等功能。

copyright © 萬盛學電腦網 all rights reserved