基礎:serialize() vs serializeArray()
| 方法 | 回傳格式 | 適用場景 |
.serialize() | URL 編碼字串 a=1&b=2 | 直接作為 AJAX data 發送 |
.serializeArray() | 陣列物件 [{name:'a',value:'1'},...] | 前端處理、轉物件、驗證 |
核心需求:轉為 { key: value } 物件
/**
* 將表單序列化為純物件 { name: value }
* 同名欄位以逗號合併(如 checkbox 群組)
* @param {jQuery|Element} form
* @returns {Object}
*/
function formToObject(form) {
var $form = $(form);
var obj = {};
$.each($form.serializeArray(), function(index, field) {
var name = field.name;
var value = field.value;
if (obj[name] !== undefined) {
// 同名欄位:陣列化或逗號合併
if (!Array.isArray(obj[name])) {
obj[name] = [obj[name]];
}
obj[name].push(value);
// 或:obj[name] = obj[name] + ',' + value;
} else {
obj[name] = value;
}
});
return obj;
}
// 使用
var formData = formToObject('#myForm');
console.log(formData);
// { username: 'john', roles: ['admin', 'user'], email: 'john@test.com' }
進階版:支援巢狀物件(name="user[name]")
/**
* 支援點號/中括號命名法的深度序列化
* name="user.name" → { user: { name: '...' } }
* name="items[0].id" → { items: [{ id: '...' }] }
*/
function formToObjectDeep(form) {
var $form = $(form);
var obj = {};
$.each($form.serializeArray(), function(_, field) {
setDeepValue(obj, field.name, field.value);
});
return obj;
}
function setDeepValue(obj, path, value) {
// 簡易實作:支援 a.b.c 格式
var keys = path.replace(/\[(\d+)\]/g, '.$1').split('.'); // items[0].id → items.0.id
var current = obj;
for (var i = 0; i < keys.length - 1; i++) {
var key = keys[i];
var nextKey = keys[i + 1];
var isArrayIndex = /^\d+$/.test(nextKey);
if (!(key in current)) {
current[key] = isArrayIndex ? [] : {};
}
current = current[key];
}
var lastKey = keys[keys.length - 1];
if (Array.isArray(current) && /^\d+$/.test(lastKey)) {
current[parseInt(lastKey)] = value;
} else {
// 同名處理
if (current[lastKey] !== undefined) {
if (!Array.isArray(current[lastKey])) {
current[lastKey] = [current[lastKey]];
}
current[lastKey].push(value);
} else {
current[lastKey] = value;
}
}
}
實戰:表單資料預覽與提交
$('#previewBtn').click(function() {
var data = formToObject('#myForm');
$('#preview').text(JSON.stringify(data, null, 2));
});
$('#submitBtn').click(function() {
var data = formToObjectDeep('#myForm');
$.ajax({
url: '/api/submit',
type: 'POST',
contentType: 'application/json',
data: JSON.stringify(data),
success: function(res) {
alert('提交成功');
}
});
});
常見坑點
- disabled 欄位不會被序列化 → 用
readonly 替代或手動補充
- 未勾選的 checkbox/radio 不會出現在結果中 → 需要時手動添加預設值
- file 輸入框無法序列化 → 檔案上傳需用
FormData
- 按鈕 type="submit" 也會被序列化 → 給按鈕加
name 時注意
現代原生替代:FormData
var form = document.getElementById('myForm');
var formData = new FormData(form);
// 轉物件
var obj = {};
for (var pair of formData.entries()) {
// 同名處理邏輯同前
if (obj[pair[0]]) {
if (!Array.isArray(obj[pair[0]])) obj[pair[0]] = [obj[pair[0]]];
obj[pair[0]].push(pair[1]);
} else {
obj[pair[0]] = pair[1];
}
}
// 直接發送(支援檔案)
fetch('/api/upload', { method: 'POST', body: formData });
總結
serializeArray() 取得結構化陣列,易於前端處理
- 封裝
formToObject() 統一專案表單資料格式
- 複雜巢狀結構用
name="a.b.c" 慣例 + 深度解析函數
- 現代專案優先
FormData,支援檔案、無需 jQuery