DIV CSS 佈局教程網

jQuery 表單序列化三兄弟:serialize()、serializeArray() 與 $.param()
編輯:JQuery特效代碼     

把表單內容打包送出的需求無所不在。手動一個個 .val() 拼字串,欄位一多就難以維護,而且很容易漏掉新加的欄位。jQuery 提供了三個層層遞進的方法來解決這件事。

serialize():序列化為查詢字串

作用於 jQuery 物件,把表單元素序列化成 key=value&key2=value2 形式的字串,正好可以直接當作 Ajax 的 data:

$("#send").click(function () {
    $.get("get1.jsp", $("#form1").serialize(), function (data, textStatus) {
        $("#resText").html(data);
    });
});

最大的好處是自動編碼。中文與特殊字元不用自己處理,也不會因為漏了 encodeURIComponent 而在後端收到亂碼。此外,即使日後在表單中新增欄位,這段程式碼也不必更動。

服務端接收(JSP 範例):

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
request.setCharacterEncoding("UTF-8");
String username = request.getParameter("username");
String content  = request.getParameter("content");
out.println("<div class='comment'><h6>" + username + " :</h6>"
          + "<p class='para'>" + content + "</p></div>");
%>

這段服務端程式有個必須指出的問題:它把使用者輸入直接寫進 HTML 輸出,是典型的 XSS 弱點。任何輸入含 <script> 的內容都會在瀏覽器中執行。正確做法是先 HTML 編碼再輸出,或改用模板引擎的自動轉義機制。

另外補充:serialize() 作用在 jQuery 物件上,因此不限於 form。任何選到的元素集合都能用:

$(":checkbox,:radio").serialize();     // 只會序列化被勾選/選取的項目

serializeArray():序列化為 JSON 結構

與 serialize 相似,但回傳的是陣列而非字串,每個元素形如 {name: ..., value: ...}:

var fields = $(":checkbox,:radio").serializeArray();
console.log(fields);   // 用 FireBug 或 devtools 輸出

這個形式很適合進一步加工——例如過濾掉空值、加上額外欄位、或直接送入模板渲染。

$.param():兩者的共同核心

serialize() 的底層就是呼叫 $.param()。它能對任意物件或陣列按 key/value 序列化,而不必是表單元素:

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

這讓它在「資料不是來自表單,但你想用查詢字串格式送出」時特別有用,例如組裝 API 的 query string。

實務上的注意事項

  • disabled 元素不會被序列化。這與瀏覽器原生表單送出的行為一致。若某欄位必須送出,請用 readonly 而非 disabled。
  • 只序列化「成功的控制項」。未被勾選的 checkbox、未選取的 radio、空的 select 都不會出現。這通常是你要的行為,但別忘了後端要處理欄位缺席的情況。
  • 巢狀結構需要 traditional 參數。jQuery 1.4 之後 $.param() 預設會把 {a: {b: 1}} 展開成 a[b]=1 形式(PHP/Rails 風格)。若後端期待 JSON 風格,需傳 $.param(obj, true)。
  • 動手序列化前先驗證。serialize() 不會幫你檢查必填欄位。實務上應先跑過驗證,通過後才序列化送出,否則只是把無效資料送得更有效率而已。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved