萬盛學電腦網

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

document.forms 集合與 submit() 方法:表單提交的原生 JS 完整指南

document.forms 基礎

`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));

submit() 方法詳解

// 直接提交
document.forms['exportServlet'].submit();

// 等同於
document.getElementById('exportServlet').submit();
document.querySelector('form[name="exportServlet"]').submit();

關鍵行為差異

方式觸發 onsubmit觸發 submit 事件HTML5 驗證備註
`form.submit()`❌ 不觸發❌ 不觸發❌ 跳過程式化提交,**繞過驗證**
`form.requestSubmit()`✅ 觸發✅ 觸發✅ 執行**現代標準推薦**(HTML Living Standard)
點擊 `✅✅✅用戶交互,標準流程
`form.dispatchEvent(new Event('submit', {cancelable:true}))`✅✅✅手動派發事件(罕用)

現代最佳實踐:requestSubmit()

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

FormData 配合 fetch/AJAX 提交

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

常見問題與避坑

  • submit() 不觸發驗證:HTML5 `required`、`pattern`、`min/max` 等驗證會被跳過 → 用 `requestSubmit()`。
  • 重複提交:提交後禁用提交按鈕 `btn.disabled = true`,或用標誌位防抖。
  • 文件上傳:`enctype="multipart/form-data"` 時**不能**手動設置 `Content-Type`,瀏覽器會自動設置 `boundary`。
  • 表單重置:`form.reset()` 重置所有控件為初始值,**不觸發** `change`/`input` 事件。
  • 名稱衝突:`form.elements.name` 會覆蓋 `form.name` 屬性,訪問表單 name 用 `form.getAttribute('name')` 或 `form.id`。

結語

`document.forms` 提供便捷的表單集合訪問,**提交時優先使用 `form.requestSubmit()` 觸發完整驗證流程**;需繞過驗證或 AJAX 提交時使用 `form.submit()` 或 `FormData + fetch`。理解 `submit()`、`requestSubmit()`、原生提交按鈕的行為差異,能避免表單驗證失效、重複提交等常見 Bug。

copyright © 萬盛學電腦網 all rights reserved