遍歷目標與場景
- 表單驗證:檢查所有必填欄位
- 資料收集:序列化表單為 JSON/查詢字串
- 狀態重置:清空、禁用/啟用、還原預設值
- 動態操作:根據條件顯示/隱藏欄位
原生 DOM API 方案 (零依賴、效能最佳)
1. 遍歷特定表單所有控制項元素
var form = document.forms['myForm']; // 或 document.getElementById('formId')
// form.elements 包含所有表單相關元素 (input, select, textarea, button, fieldset...)
for (var i = 0; i < form.elements.length; i++) {
var el = form.elements[i];
console.log(el.name, el.type, el.value, el.tagName);
}
// ES6 簡潔寫法
[...form.elements].forEach(function(el) {
// 處理邏輯
});
2. 依類型過濾處理
// 停用所有按鈕、設定檔案輸入為唯讀
[...form.elements].forEach(function(el) {
switch (el.type.toLowerCase()) {
case 'button':
case 'submit':
case 'reset':
el.disabled = true;
break;
case 'file':
el.readOnly = true; // 注意:file input 唯讀行為瀏覽器差異大
break;
}
});
3. 取得所有文字類輸入框的值
var textInputs = document.querySelectorAll('input[type="text"], input[type="password"], input[type="email"], input[type="search"], input[type="url"], input[type="tel"], textarea');
var values = [];
textInputs.forEach(function(input) {
values.push({ name: input.name, value: input.value, id: input.id });
});
console.log(values);
4. 遞迴遍歷任意容器下所有元素 (通用)
/**
* 遞迴遍歷節點樹
* @param {Node} node - 起始節點
* @param {Function} callback - 處理函數 callback(node, depth)
*/
function traverseDOM(node, callback, depth) {
depth = depth || 0;
callback(node, depth);
node = node.firstChild;
while (node) {
traverseDOM(node, callback, depth + 1);
node = node.nextSibling;
}
}
// 使用:列印所有元素標籤名
traverseDOM(document.body, function(node, depth) {
if (node.nodeType === Node.ELEMENT_NODE) {
console.log(new Array(depth + 1).join(' ') + '<' + node.tagName.toLowerCase() + '>');
}
});
jQuery 方案 (舊專案維護)
// 1. 表單元素遍歷
$('#myForm :input').each(function() {
var $this = $(this);
console.log($this.attr('name'), $this.attr('type'), $this.val());
});
// 2. 特定類型
$('#myForm input[type="text"]').each(function() { ... });
// 3. 序列化表單 (最常用)
var formData = $('#myForm').serialize(); // 查詢字串: name=value&age=20
var formArray = $('#myForm').serializeArray(); // 陣列: [{name:'name', value:'value'}, ...]
var formObject = $('#myForm').serializeObject(); // 需插件或自寫轉物件
// 4. 取值/設值
var val = $('input[name="username"]').val();
$('input[name="username"]').val('new value');
現代 ES6+ 最佳實踐
FormData API (標準、支援檔案、直接可送 fetch)
var form = document.getElementById('myForm');
var formData = new FormData(form); // 自動收集所有 name 屬性的元素
// 轉物件
var data = {};
for (var pair of formData.entries()) {
// 處理同名多值 (如 checkbox 群組)
if (data[pair[0]]) {
if (!Array.isArray(data[pair[0]])) data[pair[0]] = [data[pair[0]]];
data[pair[0]].push(pair[1]);
} else {
data[pair[0]] = pair[1];
}
}
// 直接送出
fetch('/api/submit', { method: 'POST', body: formData });
表單元素陣列化 + reduce 收集
const form = document.getElementById('myForm');
const data = [...form.elements]
.filter(el => el.name && !el.disabled && ['submit','reset','button','image'].indexOf(el.type) === -1)
.reduce((acc, el) => {
// checkbox/radio 未勾選不收集
if (['checkbox','radio'].includes(el.type) && !el.checked) return acc;
// select multiple
if (el.tagName === 'SELECT' && el.multiple) {
acc[el.name] = [...el.selectedOptions].map(o => o.value);
} else {
acc[el.name] = el.value;
}
return acc;
}, {});
動態表單驗證範例
function validateForm(form) {
const errors = [];
[...form.elements].forEach(el => {
if (!el.name || el.disabled) return;
// required
if (el.required && !el.value.trim()) {
errors.push({ field: el.name, message: '必填' });
}
// pattern
if (el.pattern && el.value) {
const regex = new RegExp(el.pattern);
if (!regex.test(el.value)) {
errors.push({ field: el.name, message: '格式錯誤' });
}
}
// type=email/number/url 瀏覽器原生驗證
if (el.validity && !el.validity.valid) {
errors.push({ field: el.name, message: el.validationMessage });
}
});
return errors;
}
// 使用
form.addEventListener('submit', e => {
const errors = validateForm(form);
if (errors.length) {
e.preventDefault();
showErrors(errors);
}
});
效能與記憶體注意事項
| 方法 | 回傳類型 | 即時性 | 效能 | 適用場景 |
form.elements | HTMLFormControlsCollection (即時) | 即時反映 DOM 變化 | 極快 (原生) | 表單專用遍歷首選 |
querySelectorAll | NodeList (靜態快照) | 不反映後續 DOM 變化 | 快 | 複雜選擇器、非表單元素 |
getElementsByTagName('*') | HTMLCollection (即時) | 即時 | 較慢 (全樹掃描) | 極舊瀏覽器降級 |
jQuery $(selector) | jQuery Object (靜態) | 不即時 | 較慢 (封裝層) | 舊專案、鏈式操作 |
總結
- 表單專用:首選
form.elements + ES6 陣列方法 (forEach, filter, reduce)。
- 資料收集:直接用
new FormData(form),標準、支援檔案、可直接 fetch。
- 驗證:善用 HTML5 原生驗證屬性 (
required, pattern, type) + validity API,減少手寫邏輯。
- 通用遍歷:
querySelectorAll 或 TreeWalker (大量節點時效能更佳)。
- 避免:
document.all、for...in 遍歷陣列、同步遍歷大量節點阻塞主執行緒。