DIV CSS 佈局教程網

jQuery 表單序列化與 JSON 的雙向轉換
編輯:JQuery特效代碼     

把表單內容轉成查詢字串、再轉成 JSON 物件,或者反過來——這是在做 Ajax 表單時反覆出現的需求。本文整理幾個可直接複用的工具函式。

起點:serialize() 產生查詢字串

var qs = $("#myform").serialize();
// width=1680&height=1050

serialize() 會依 URL 編碼規則把表單內容組成一條查詢字串,格式是 key=value&key2=value2。若表單含有 file 上傳欄位,則必須改用 FormData,因為 serialize 不處理檔案。

查詢字串 → JSON 物件

$.par2Json = function (string, overwrite) {
    var obj = {},
        pairs = string.split('&'),
        d = decodeURIComponent,
        name, value;

    $.each(pairs, function (i, pair) {
        pair = pair.split('=');
        name = d(pair[0]);
        value = d(pair[1]);
        // 同名參數:overwrite 為 true 時直接覆蓋,否則併成陣列
        obj[name] = overwrite || !obj[name] ? value
                  : [].concat(obj[name]).concat(value);
    });
    return obj;
};

// 使用
$.par2Json("width=1680&height=1050");
// => { width: "1680", height: "1050" }

這裡有兩個細節值得注意。一是用 decodeURIComponent() 還原編碼過的值,否則中文與特殊字元會是一團亂碼。二是同名參數的處理:overwrite 為 true 時後者蓋前者,為 false 時則合併成陣列,如此 a=1&a=2 就會變成 {a: [1, 2]},與 PHP 等後端語言解析 a[]=1&a[]=2 的行為對齊。

JSON 物件 → 查詢字串

jQuery 本身已內建 $.param():

$.param({ width: 1680, height: 1050 });
// => "width=1680&height=1050"

$.param({ a: [1, 2] });   // 陣列會展開成 a[]=1&a[]=2

若想自己實作,可以參考下面的寫法:

$.json2Par = function (o, pre) {
    var undef, buf = [], key, e = encodeURIComponent;

    for (key in o) {
        undef = o[key] == 'undefined';
        $.each(undef ? key : o[key], function (val, i) {
            buf.push("&", e(key), "=", (val != key || !undef) ? e(val) : "");
        });
    }

    if (!pre) {
        buf.shift();     // 拿掉最前面的 &
        pre = "";
    }
    return pre + buf.join('');
};

// 使用
$.json2Par({ width: 1680, height: 1050 });

buf.shift() 那一行是為了去掉第一個多餘的 &——因為迴圈每次都先 push 分隔符號,最後再移除頭一個。這是字串拼接常見的小技巧。

實務上的取捨

絕大多數情況直接用內建的 $.param() 與 $("#form").serialize() 就好,不必自己造。serialize() 有幾個行為要留意:它只序列化成功控制項(successful controls),也就是未 disabled、有 name 的欄位;未勾選的 checkbox 與 radio 不會出現;type=file 的欄位會被忽略。

如果需要更完整的表單序列化,可以考慮 serializeArray(),它回傳的是 [{name:..., value:...}, ...] 的陣列,適合需要逐項處理或過濾的場景:

$("#myform").serializeArray()
    .filter(function (item) { return item.name !== "csrf"; })
    .forEach(function (item) { console.log(item.name, item.value); });

至於「要不要轉成 JSON」這個問題,其實取決於後端介面。若後端是 PHP 之類以 $_POST 接收的傳統腳本,直接送查詢字串最省事;若後端是走 JSON API 的服務,那麼設定 contentType: "application/json" 並用 JSON.stringify() 序列化會更直接,也不必來回轉換。

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