`form.elements` 集合中的元素順序,嚴格按照 HTML 文檔中出現的順序排列。 即:文檔流中先出現的表單控件,在 `elements` 集合中索引越小。
<form id="demoForm">
<input name="first" value="1">
<select name="second"><option>A</option></select>
<textarea name="third">Text</textarea>
<button name="fourth">Btn</button>
<input type="hidden" name="hidden" value="x">
</form>
<script>
const form = document.getElementById('demoForm');
console.log('elements.length:', form.elements.length); // 5
[...form.elements].forEach((el, i) => {
console.log(i, el.tagName, el.name, el.type);
});
/*
0 INPUT first text
1 SELECT second select-one
2 TEXTAREA third textarea
3 BUTTON fourth submit
4 INPUT hidden hidden
*/
</script>
| 方式 | 語法 | 特點 |
|---|---|---|
| 索引訪問 | `form.elements[0]` | 順序依賴 HTML 結構,結構變動易破壞 |
| 名稱訪問 | `form.elements['username']` | 推薦:語義化、抗結構變動、支援同名元素返回 RadioNodeList |
| ID 訪問 | `document.getElementById('id')` | 全局唯一,不限於表單內部 |
| 屬性訪問(舊) | `form.username` | 非標準、名稱衝突風險大,**不推薦** |
function serializeForm(form) {
const data = {};
for (const el of form.elements) {
if (!el.name || el.disabled) continue;
if (el.type === 'checkbox' || el.type === 'radio') {
if (!el.checked) continue;
}
if (el.type === 'select-multiple') {
data[el.name] = [...el.selectedOptions].map(o => o.value);
} else {
data[el.name] = el.value;
}
}
return data;
}
function validateForm(form) {
for (const el of form.elements) {
if (el.hasAttribute('required') && !el.value.trim()) {
el.reportValidity(); // 瀏覽器原生提示
return false;
}
}
return true;
}
function resetForm(form) {
form.reset(); // 原生重置,含輸入框、選擇框、勾選框
}
function addField(form, name, type = 'text') {
const wrapper = document.createElement('div');
const input = document.createElement('input');
input.name = name;
input.type = type;
wrapper.appendChild(input);
form.insertBefore(wrapper, form.querySelector('button[type="submit"]'));
// elements 集合自動同步,無需手動維護索引
}
<input type="image">、<button> 也在集合中。掌握 `form.elements` 的**文檔順序特性**與**名稱索引語義化訪問**,是高效處理表單數據的關鍵。現代開發推薦配合 `FormData` API:
const formData = new FormData(form); // 自動收集所有名稱+值
fetch('/api/submit', { method: 'POST', body: formData });