傳統做法需逐一 document.getElementById() 或 $('input[name=x]').val(),欄位一多極易遺漏、難維護。本文介紹一種約定優於配置的策略:在每個需提交的表單元素加上自訂屬性 _postField,統一由單一函式遍歷收集,自動組裝成 JSON 物件送往後端。
/**
* 依 _postField 屬性收集表單資料
* @param {string} attrName - 自訂屬性名,預設 "_postField"
* @returns {Object} key-value 物件,key=_postField 值,value=元素值
*/
function getFormField(attrName) {
attrName = attrName || '_postField';
var $fields = $('[' + attrName + ']'); // 選取所有擁有此屬性的元素
var data = {};
$fields.each(function() {
var $el = $(this);
var key = $el.attr(attrName);
var tag = this.tagName.toLowerCase();
var type = this.type ? this.type.toLowerCase() : '';
var val;
switch (tag) {
case 'input':
if (type === 'radio' || type === 'checkbox') {
if (!this.checked) return; // 未勾選跳過
if (type === 'radio') {
data[key] = $el.val(); // 單選直接覆蓋
} else { // checkbox 多選合併為逗號字串
data[key] = (data[key] ? data[key] + ',' : '') + $el.val();
}
} else { // text, hidden, password, email, number...
data[key] = $el.val();
}
break;
case 'textarea':
data[key] = $el.val();
break;
case 'select':
data[key] = $el.val(); // jQuery val() 自動處理單/多選
break;
default:
data[key] = $el.html(); // 其他元素取 innerHTML
}
});
return data;
}
<form id="myForm">
<input type="text" _postField="username" placeholder="用戶名" /><br/>
<input type="radio" name="gender" value="M" _postField="gender" />男
<input type="radio" name="gender" value="F" _postField="gender" />女<br/>
<input type="checkbox" value="js" _postField="skills" />JavaScript
<input type="checkbox" value="css" _postField="skills" />CSS<br/>
<select _postField="city">
<option value="tp">台北</option>
<option value="kc">高雄</option>
</select><br/>
<button type="button" onclick="submitForm()">送出</button>
</form>
function submitForm() {
var postData = getFormField('_postField');
console.log('送出資料:', postData);
// { username: "...", gender: "M", skills: "js,css", city: "tp" }
$.ajax({
url: '/api/submit',
type: 'POST',
dataType: 'json',
data: postData,
success: function(res) { alert('成功'); }
});
}
| 優點 | 缺點/注意事項 |
|---|---|
| 零配置:新增欄位只需加 _postField | 非標準屬性,HTML 驗證會警告(可改用 data-post-field) |
| 自動處理 radio/checkbox/select 多樣型別 | checkbox 合併為逗號字串,後端需自行分割 |
| 程式碼集中、易維護、易擴充 | 檔案上傳 需用 FormData,不適用此法 |
| 可搭配驗證庫(如 validate.js)共用選擇器 | 動態新增元素需重新掃描或用事件代理 |
<input type="text" data-field="username" />
// 原生 FormData + 選擇器收集(支援檔案)
function collectFormData(formSel) {
var form = document.querySelector(formSel);
var fd = new FormData(form); // 自動包含所有 name 屬性欄位
// 若需只收集 data-field 的欄位:
var data = {};
form.querySelectorAll('[data-field]').forEach(el => {
var key = el.dataset.field;
if (el.type === 'checkbox') {
if (el.checked) data[key] = (data[key] ? data[key] + ',' : '') + el.value;
} else if (el.type === 'radio') {
if (el.checked) data[key] = el.value;
} else {
data[key] = el.value;
}
});
return data;
}
自訂屬性 _postField(或標準 data-field)配合 jQuery 選擇器遍歷,能以極少程式碼實現表單資料的自動化 JSON 序列化。核心邏輯在於統一入口、型別分派、多值合併三步驟。現代專案建議改用 FormData 搭配 data-* 屬性,同時支援檔案上傳並符合 HTML 標準。