萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery serialize() 序列化表單完整指南

什麼是 serialize()?

serialize() 將表單元素的值編碼為標準 URL 查詢字串格式(key1=value1&key2=value2...),常用於 AJAX 提交。它作用於 jQuery 物件(表單元素集合或 <form> 本身)。

基本語法

$(selector).serialize()

核心規則

  1. 僅序列化「成功的控制項」:具 name 屬性、未被禁用、勾選狀態(checkbox/radio)或非檔案上傳類型。
  2. 提交按鈕(<input type="submit">)若非透過點擊觸發提交,其值不會被序列化。
  3. name 屬性值避免使用 JavaScript 保留字(如 length),否則可能無法取值。

實戰範例

1. AJAX 提交表單

$.ajax({
    type: 'POST',
    dataType: 'json',
    url: '/api/submit',
    data: $('#myForm').serialize(),
    success: function(res) { console.log(res); }
});

2. 直接取得序列化字串

<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() 內部流程:

  1. serializeArray() 將表單轉為物件陣列:[{name:'username', value:'admin'}, {name:'password', value:'admin123'}]
  2. $.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() 關係,能靈活應對複雜表單提交場景。

copyright © 萬盛學電腦網 all rights reserved