萬盛學電腦網

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

JavaScript 取得頁面表單數量:document.forms.length 完整教學

前言

document.forms 回傳文檔中所有 <form> 元素組成的 **HTMLCollection** (即時集合)。.length 即為表單總數。本文說明用法、索引/名稱存取、表單元素操作與現代替代方案。

基本語法

const formCount = document.forms.length; // Number

完整範例

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>表單計數範例</title>
</head>
<body>
  <h1>sharejs.com</h1>
  <form name="Form1"><input name="a"></form>
  <form name="Form2"><input name="b"></form>
  <form><input name="c"></form> <!-- 無 name -->
  <p>表單數量:<span id="count"></span></p>
  <script>
    document.getElementById('count').textContent = document.forms.length;
  </script>
</body>
</html>

輸出:3

document.forms 進階存取

存取方式語法說明
索引document.forms[0]文檔順序第一個表單
name 屬性document.forms['Form1'] 或 document.forms.Form1對應 name (非 id),同名時回傳 HTMLCollection
id 選取document.getElementById('formId')推薦現代做法,精確唯一

範例:透過 name 存取並提交

// 假設有 
...
document.forms.login.submit(); // 直接提交 // 或 document.forms['login'].elements.username.value = 'admin';

表單元素操作 (HTMLFormElement.elements)

const form = document.forms[0];
const elements = form.elements; // HTMLFormControlsCollection

// 遍歷所有表單控制項
Array.from(elements).forEach(el => {
  console.log(el.name, el.type, el.value);
});

// 依 name 存取 (同名群組回傳 RadioNodeList)
const username = form.elements.username; // 
const gender = form.elements.gender;     // RadioNodeList (多個 radio)
console.log(gender.value);               // 取得被選中的 radio value

實務應用場景

1. 統一序列化所有表單資料

function serializeAllForms() {
  const data = {};
  Array.from(document.forms).forEach((form, i) => {
    const formData = new FormData(form);
    data[form.name || `form_${i}`] = Object.fromEntries(formData);
  });
  return data;
}

2. 頁面離開前檢查未儲存表單

let formDirty = false;
document.querySelectorAll('form input, form textarea, form select').forEach(el => {
  el.addEventListener('input', () => formDirty = true);
});
window.addEventListener('beforeunload', e => {
  if (formDirty) {
    e.preventDefault();
    e.returnValue = '有未儲存的變更,確定離開?';
  }
});

3. 動態新增表單自動偵測

let lastCount = document.forms.length;
new MutationObserver(() => {
  if (document.forms.length > lastCount) {
    console.log('新增表單:', document.forms[document.forms.length - 1]);
    lastCount = document.forms.length;
  }
}).observe(document.body, { childList: true, subtree: true });

document.forms vs querySelectorAll('form')

特性document.formsquerySelectorAll('form')
集合類型HTMLCollection (即時)NodeList (靜態)
name 索引支援 forms['name']不支援
elements 集合表單元素有 .elements需自行 form.querySelectorAll(...)
效能極快 (瀏覽器內建)查詢時遍歷

注意事項

  • <form> **巢狀嵌套無效** (HTML 規範禁止),內層 form 會被忽略或提升為兄弟節點。
  • 無 name 的表單無法透過 document.forms.name 存取,僅能用索引或 querySelector。
  • 即時集合迴圈中修改 (如刪除表單) 會導致索引錯位,**轉陣列處理**:Array.from(document.forms).forEach(...)。
  • 跨域 iframe 內表單**不包含**在父頁面集合中。

總結

document.forms.length 即時取得頁面表單總數。善用 form.elements 存取控制項、FormData 序列化、MutationObserver 監控動態變化。現代專案精確選取單一表單請用 document.getElementById 或 querySelector,批次操作可用 document.forms 即時特性。

copyright © 萬盛學電腦網 all rights reserved