`document.forms` 返回 **HTMLCollection**(即時集合),包含文檔中所有 `
// 1. 索引訪問(按文檔順序) document.forms[0]; // 第一個 form document.forms[1]; // 第二個 form // 2. 名稱/ID 訪問 document.forms['loginForm']; // name="loginForm" 或 id="loginForm" document.forms.loginForm; // 同樣可用(屬性訪問) // 3. 長度 document.forms.length; // form 數量 // 4. 遍歷 Array.from(document.forms).forEach(form => console.log(form.name, form.id));
// 直接提交 document.forms['exportServlet'].submit(); // 等同於 document.getElementById('exportServlet').submit(); document.querySelector('form[name="exportServlet"]').submit();
const form = document.forms['exportServlet']; // 推薦:觸發完整提交流程(驗證、onsubmit、submit 事件) form.requestSubmit(); // 需在提交前驗證/修改數據 form.addEventListener('submit', (e) => { if (!validateForm(form)) { e.preventDefault(); // 阻止提交 return; } // 添加 CSRF token 等 const token = document.querySelector('meta[name="csrf-token"]').content; const input = document.createElement('input'); input.type = 'hidden'; input.name = '_token'; input.value = token; form.appendChild(input); }); // 若必須繞過驗證(如草稿保存) function saveDraft() { // 臨時移除 required 或 novalidate form.setAttribute('novalidate', ''); form.submit(); // 不觸發驗證 form.removeAttribute('novalidate'); }
async function submitFormAjax(form) { const formData = new FormData(form); // 自動收集所有表單字段 // 可追加額外數據 formData.append('timestamp', Date.now()); try { const response = await fetch(form.action, { method: form.method || 'POST', body: formData, credentials: 'same-origin' // 攜帶 Cookie }); if (!response.ok) throw new Error(`HTTP ${response.status}`); const result = await response.json(); return result; } catch (err) { console.error('提交失敗:', err); throw err; } } // 綁定 document.forms['myForm'].addEventListener('submit', async (e) => { e.preventDefault(); // 阻止默認提交 await submitFormAjax(e.target); });
`document.forms` 提供便捷的表單集合訪問,**提交時優先使用 `form.requestSubmit()` 觸發完整驗證流程**;需繞過驗證或 AJAX 提交時使用 `form.submit()` 或 `FormData + fetch`。理解 `submit()`、`requestSubmit()`、原生提交按鈕的行為差異,能避免表單驗證失效、重複提交等常見 Bug。