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;
};
name/value。checkbox、select multiple 等控件提交同名多值,插件自動合併為數組。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()); // 注意:同名鍵會被覆蓋,需額外處理
理解插件原理,有助於在無依賴環境下快速實現同等功能。