/**
* 將表單元素序列化為 { name: value, ... } 物件
* - 同名欄位以逗號合併(如 checkbox 群組)
* - 忽略 disabled 欄位
* @param {HTMLFormElement|jQuery} form 表單元素或 jQuery 物件
* @returns {Object}
*/
function formToObject(form) {
const $form = form instanceof jQuery ? form : $(form);
const obj = {};
$.each($form.serializeArray(), function (_, field) {
const { name, value } = field;
if (obj[name] !== undefined) {
// 已存在 → 合併為逗號分隔字串
obj[name] = obj[name] + ',' + value;
} else {
obj[name] = value;
}
});
return obj;
}
// 使用範例
$('#myForm').on('submit', function (e) {
e.preventDefault();
const data = formToObject(this);
console.log(data); // { username: 'alice', role: 'admin,user', bio: '...' }
// $.post('/api/save', data, ...);
});
serializeArray() 回傳陣列:[{name:'a', value:'1'}, {name:'b', value:'2'}, ...],自動處理 ``、`request.getParameterValues() 或 String[] 接收)。JSON.stringify 送出 AJAX。function formToJson(form, options = {}) {
const {
arrays = 'comma', // 'comma' | 'array' | 'last'
booleans = true, // checkbox 未勾選是否包含 false
nested = true, // 支援 name="user[name]" 解析為巢狀
includeDisabled = false
} = options;
const $form = form instanceof jQuery ? form : $(form);
const data = {};
$form.find(':input').not('[disabled]').each(function () {
if (!includeDisabled && this.disabled) return;
const name = this.name;
if (!name) return;
let value;
if (this.type === 'checkbox' || this.type === 'radio') {
if (!this.checked) {
if (booleans) value = false;
else return; // 跳過未勾選
} else {
value = this.value || true; // 無 value 時視為 true
}
} else if (this.tagName === 'SELECT' && this.multiple) {
value = $(this).val() || []; // 陣列
} else {
value = this.value;
}
if (nested && name.includes('[')) {
// 簡易巢狀解析:user[name] → { user: { name: value } }
setNested(data, name, value, arrays);
} else {
assignValue(data, name, value, arrays);
}
});
return data;
}
// 內部輔助:巢狀鍵設值
function setNested(obj, key, value, arrayMode) {
const parts = key.replace(/\]/g, '').split('[');
let cur = obj;
for (let i = 0; i < parts.length - 1; i++) {
const p = parts[i];
cur[p] = cur[p] || {};
cur = cur[p];
}
assignValue(cur, parts[parts.length - 1], value, arrayMode);
}
// 內部輔助:同名合併策略
function assignValue(obj, key, value, arrayMode) {
if (obj[key] === undefined) {
obj[key] = value;
} else {
if (arrayMode === 'array') {
obj[key] = [].concat(obj[key], value);
} else if (arrayMode === 'last') {
obj[key] = value;
} else { // 'comma'
obj[key] = obj[key] + ',' + value;
}
}
}
| 需求 | 推薦方案 |
|---|---|
| 簡單表單、後端接收 CSV 字串 | 基礎版 formToObject |
後端期望 JSON 陣列(如 role: ['admin','user']) | 進階版 arrays: 'array' |
巢狀 DTO(如 user[name] → {user:{name}}) | 進階版 nested: true |
| 含檔案上傳 | 改用 FormData,不可序列化為 JSON |
| 需驗證/轉型 | 配合 joi/yup 驗證物件 |
function formToObjectNative(formEl) {
const fd = new FormData(formEl);
const obj = {};
for (const [key, value] of fd.entries()) {
if (obj[key] !== undefined) obj[key] += ',' + value;
else obj[key] = value;
}
return obj;
}
// 使用
document.getElementById('myForm').addEventListener('submit', e => {
e.preventDefault();
const data = formToObjectNative(e.target);
fetch('/api/save', { method: 'POST', headers: {'Content-Type':'application/json'}, body: JSON.stringify(data) });
});
選擇適合專案複雜度的版本,讓表單資料收集既標準又彈性。