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[0] | 文檔順序第一個表單 |
| name 屬性 | document.forms['Form1'] 或 document.forms.Form1 | 對應 name (非 id),同名時回傳 HTMLCollection |
| id 選取 | document.getElementById('formId') | 推薦現代做法,精確唯一 |
// 假設有
document.forms.login.submit(); // 直接提交
// 或
document.forms['login'].elements.username.value = 'admin';
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
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;
}
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 = '有未儲存的變更,確定離開?';
}
});
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 | querySelectorAll('form') |
|---|---|---|
| 集合類型 | HTMLCollection (即時) | NodeList (靜態) |
| name 索引 | 支援 forms['name'] | 不支援 |
| elements 集合 | 表單元素有 .elements | 需自行 form.querySelectorAll(...) |
| 效能 | 極快 (瀏覽器內建) | 查詢時遍歷 |
<form> **巢狀嵌套無效** (HTML 規範禁止),內層 form 會被忽略或提升為兄弟節點。name 的表單無法透過 document.forms.name 存取,僅能用索引或 querySelector。Array.from(document.forms).forEach(...)。document.forms.length 即時取得頁面表單總數。善用 form.elements 存取控制項、FormData 序列化、MutationObserver 監控動態變化。現代專案精確選取單一表單請用 document.getElementById 或 querySelector,批次操作可用 document.forms 即時特性。