serialize()?serialize() 將表單元素的值編碼為標準 URL 查詢字串格式(key1=value1&key2=value2...),常用於 AJAX 提交。它作用於 jQuery 物件(表單元素集合或 <form> 本身)。
$(selector).serialize()
name 屬性、未被禁用、勾選狀態(checkbox/radio)或非檔案上傳類型。<input type="submit">)若非透過點擊觸發提交,其值不會被序列化。name 屬性值避免使用 JavaScript 保留字(如 length),否則可能無法取值。$.ajax({
type: 'POST',
dataType: 'json',
url: '/api/submit',
data: $('#myForm').serialize(),
success: function(res) { console.log(res); }
});
<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>
<script>
$('#submit').click(function(){
alert($('#myForm').serialize());
// 輸出: username=admin&password=admin123
});
</script>
.param() 與 .serializeArray()serialize() 內部流程:
serializeArray() 將表單轉為物件陣列:[{name:'username', value:'admin'}, {name:'password', value:'admin123'}]$.param() 將陣列轉為 URL 編碼字串。$.param() 直接處理物件var obj = {a:1, b:2, c:3};
console.log($.param(obj)); // "a=1&b=2&c=3"
serialize() 不支援 <input type="file">,需改用 FormData。$.param() 支援深度序列化(如 {arr:[1,2]} → arr[]=1&arr[]=2),但後端解析需配合(PHP 需 arr[],Node/Express 需 extended: true)。encodeURIComponent,中文會被編碼,後端自動解碼即可。serialize() 是表單 AJAX 化的利器,掌握其序列化規則與底層 $.param()、serializeArray() 關係,能靈活應對複雜表單提交場景。