把表單內容打包送出的需求無所不在。手動一個個 .val() 拼字串,欄位一多就難以維護,而且很容易漏掉新加的欄位。jQuery 提供了三個層層遞進的方法來解決這件事。
作用於 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(); // 只會序列化被勾選/選取的項目
與 serialize 相似,但回傳的是陣列而非字串,每個元素形如 {name: ..., value: ...}:
var fields = $(":checkbox,:radio").serializeArray();
console.log(fields); // 用 FireBug 或 devtools 輸出
這個形式很適合進一步加工——例如過濾掉空值、加上額外欄位、或直接送入模板渲染。
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。
readonly 而非 disabled。traditional 參數。jQuery 1.4 之後 $.param() 預設會把 {a: {b: 1}} 展開成 a[b]=1 形式(PHP/Rails 風格)。若後端期待 JSON 風格,需傳 $.param(obj, true)。serialize() 不會幫你檢查必填欄位。實務上應先跑過驗證,通過後才序列化送出,否則只是把無效資料送得更有效率而已。