DIV CSS 佈局教程網

用 jQuery 把表單序列化成 JSON 物件:serializeObject 擴充方法
編輯:JavaScript綜合知識     

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 覆寫,就只會留下最後一筆。

這裡的邏輯是:

  1. 第一次遇到某個 name,直接指派值。
  2. 再次遇到相同 name 時,檢查現有值是否為陣列(用 push 屬性判斷);若不是,先包成陣列。
  3. 把新值 push 進去。

於是同名欄位會自動收斂成陣列,不同名欄位維持純量,資料結構剛好符合後端接收表單的直覺。

幾個實務提醒

  • 只會收集成功控件:serializeArray() 遵循 HTML 規範,只序列化有 name、且未 disabled 的表單控件。未勾選的 checkbox 與 radio 不會出現,後端需自行以「不存在即為 false」處理。
  • 空值處理:範例中的 this.value || '' 可以避免 undefined,但也會把數值 0 轉成空字串。若表單可能有 0 值欄位,建議改成 this.value != null ? this.value : ''。
  • ES6 簡化寫法:現代專案可用 Object.fromEntries(new FormData(form)) 達到類似效果,程式碼更短,但同名欄位處理需另行處理。
  • 安全性:序列化結果若直接 innerHTML 輸出,記得先轉義,避免 XSS。

這個小擴充方法不到二十行,卻能省下大量手寫取值與組件的樣板程式碼,是 jQuery 時代非常值得收進工具箱的常用函式。

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