萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 表單元素訪問:elements 集合與索引順序詳解

核心結論

`form.elements` 集合中的元素順序,嚴格按照 HTML 文檔中出現的順序排列。 即:文檔流中先出現的表單控件,在 `elements` 集合中索引越小。

驗證 Demo

<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`非標準、名稱衝突風險大,**不推薦**

實戰場景

1. 表單序列化(原生)

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;
}

2. 批量驗證/重置

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(); // 原生重置,含輸入框、選擇框、勾選框
}

3. 動態增減字段時的索引維護

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 集合自動同步,無需手動維護索引
}

注意事項

  • `form.elements` **只包含表單控件**(input, select, textarea, button, fieldset, output),不包含純結構標籤(div, span, p)。
  • <input type="image">、<button> 也在集合中。
  • 同名控件(如 radio group)返回 `RadioNodeList`,可用 `.value` 取得選中值。
  • 隱藏字段(`type="hidden"`)同樣包含在內。
  • 嵌套 `
    ` 非法(HTML 規範禁止),不會出現巢狀集合。

總結

掌握 `form.elements` 的**文檔順序特性**與**名稱索引語義化訪問**,是高效處理表單數據的關鍵。現代開發推薦配合 `FormData` API:

const formData = new FormData(form); // 自動收集所有名稱+值
fetch('/api/submit', { method: 'POST', body: formData });
copyright © 萬盛學電腦網 all rights reserved