DIV CSS 佈局教程網

jQuery serialize() 用法詳解:表單序列化與底層原理
編輯:JQuery特效代碼     

要一次把表單資料送出去,serialize() 是最省事的做法。這篇從定義講到 param 與 serializeArray 的底層實作。

一、定義與語法

$(selector).serialize()

serialize() 會把表單元素集合序列化成標準的 URL 編碼字串,非常適合直接塞進 Ajax 請求的 query string。你可以選 input、textarea 等單一元素,也可以直接選 form 本身。

幾個實務上要注意的點:

  • 它只序列化「成功的控制項」。如果是用按鈕觸發送出,該按鈕的值不會被序列化。
  • 元素必須有 name 屬性,否則不會被收進結果裡。
  • name 不要取 JavaScript 或 jQuery 的關鍵字,例如 length。下面的例子就是反例:
<form id="form1">
    <input name="length" type="text" value="pipi" />
    <input name="blog" type="text" value="blue submarine" />
</form>

// 使用
$("#form1").serialize();

因為 length 撞上了關鍵字,這段就拿不到預期的值。

二、實戰範例

1. 搭配 Ajax 送出

$.ajax({
    type: "POST",
    dataType: "json",
    url: ajaxCallBack,
    data: $('#myForm').serialize(),   // 要提交表單的 ID
    success: function (msg) {
        alert(msg);
    }
});

2. 單純序列化看看結果

<script src="jquery-1.7.min.js"></script>
<script>
$(function () {
    $("#submit").click(function () {
        alert($("#myForm").serialize());
    });
});
</script>
<form id="myForm">
    昵稱 <input type="text" name="username" value="admin" /><br />
    密碼 <input type="password" name="password" value="admin123" /><br />
    <input type="button" id="submit" value="序列化表單" />
</form>

點擊後會彈出:

username=admin&password=admin123

三、底層原理:param 與 serializeArray

serialize() 其實是 serializeArray() 加上 param() 的包裝。

1. $.param()——serialize() 的核心,負責把陣列或物件按 key/value 序列化:

param: function (a) {
    var s = [];

    function add(key, value) {
        s[s.length] = encodeURIComponent(key) + '=' + encodeURIComponent(value);
    };

    // 傳入陣列時,視為表單元素集合
    if (jQuery.isArray(a) || a.jquery)
        jQuery.each(a, function () {
            add(this.name, this.value);
        });
    // 否則視為 key/value 物件
    else
        for (var j in a)
            if (jQuery.isArray(a[j]))
                jQuery.each(a[j], function () {
                    add(j, this);
                });
            else
                add(j, jQuery.isFunction(a[j]) ? a[j]() : a[j]);

    return s.join("&").replace(/%20/g, "+");
}

用起來就是:

var obj = { a: 1, b: 2, c: 3 };
var k = $.param(obj);
alert(k);      // 輸出 a=1&b=2&c=3

2. serializeArray()——把表單各欄位序列化成陣列:

serializeArray: function () {
    return this.map(function () {
        return this.elements ? jQuery.makeArray(this.elements) : this;
    })
    .filter(function () {
        return this.name && !this.disabled &&
            (this.checked || /select|textarea/i.test(this.nodeName) ||
             /text|hidden|password|search/i.test(this.type));
    })
    .map(function (i, elem) {
        var val = jQuery(this).val();
        return val == null ? null :
            jQuery.isArray(val) ?
                jQuery.map(val, function (val, i) {
                    return { name: elem.name, value: val };
                }) :
                { name: elem.name, value: val };
    }).get();
}

輸出的資料結構長這樣:

[ {
    name  : username,
    value : 中國
}, {
    name  : password,
    value : xxx
}]

理解這一層之後,要客製序列化規則(例如加上前綴、排除特定欄位)就只是自己組字串的問題了。

希望這篇對大家的 jQuery 開發有幫助。

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