jQuery 內建的 serialize() 會把表單資料序列化成 URL 查詢字串格式,serializeArray() 則回傳 [{name: ..., value: ...}, ...] 的陣列。但實務上我們更常需要一個可以直接操作的鍵值物件,特別是要透過 AJAX 送出 JSON 的時候。
只要擴充一個 jQuery 方法即可:
$.fn.serializeObject = function () {
var o = {};
var a = this.serializeArray();
$.each(a, function () {
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;
};
使用方式:
var data = $('#myForm').serializeObject();
console.log(data);
這段實作的關鍵在於處理同名欄位。像多選 checkbox 或多個 name="tags" 的輸入框,在 HTML 裡是合法且常見的寫法,若無腦用 o[name] = value 覆寫,就只會留下最後一筆。
這裡的邏輯是:
push 屬性判斷);若不是,先包成陣列。於是同名欄位會自動收斂成陣列,不同名欄位維持純量,資料結構剛好符合後端接收表單的直覺。
serializeArray() 遵循 HTML 規範,只序列化有 name、且未 disabled 的表單控件。未勾選的 checkbox 與 radio 不會出現,後端需自行以「不存在即為 false」處理。this.value || '' 可以避免 undefined,但也會把數值 0 轉成空字串。若表單可能有 0 值欄位,建議改成 this.value != null ? this.value : ''。Object.fromEntries(new FormData(form)) 達到類似效果,程式碼更短,但同名欄位處理需另行處理。這個小擴充方法不到二十行,卻能省下大量手寫取值與組件的樣板程式碼,是 jQuery 時代非常值得收進工具箱的常用函式。