萬盛學電腦網

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

DOM 表單操作全解析:元素訪問、公共屬性、提交控制與驗證

表單 DOM 核心概念

<form> 在 DOM 中對應 HTMLFormElement,擁有豐富的屬性、方法與集合,是前端數據收集與驗證的中樞。

一、獲取表單與元素

1. 獲取 <form> 本身

// 1. 通過 name(推薦,語義化)
var form = document.forms['myForm'];
// 或 document.myForm(不推薦,污染全域)

// 2. 通過索引(脆弱,結構變動易壞)
var form = document.forms[0];

// 3. 通用選擇器
var form = document.getElementById('myForm');
var form = document.querySelector('form[name="myForm"]');

2. 獲取表單內控件

var form = document.forms['myForm'];

// elements 集合:包含所有表單控件(input/select/textarea/button/fieldset 等)
var allControls = form.elements; // HTMLFormControlsCollection

// 方式 A:索引
var firstControl = allControls[0];

// 方式 B:name 屬性(推薦)
var username = allControls['username']; // 單一控件
var radios = allControls['gender']; // 同名單選 → RadioNodeList

// 方式 C:ID 選擇器(跨表單也可用)
var email = document.getElementById('email');

3. RadioNodeList 特殊行為

var genders = form.elements['gender']; // RadioNodeList
console.log(genders.value); // 直接取得被選中的 value
genders.value = 'female'; // 直接設置選中項(神奇語法!)

二、控件公共屬性與方法

屬性/方法說明適用控件
name提交鍵名全部
value當前值(可讀寫)輸入類、select、textarea
type控件類型字串全部
disabled禁用狀態(布林)全部
readonly唯讀(不提交也不可編輯)text/password/textarea
required必填(HTML5 驗證)輸入類、select、textarea
checkValidity()檢查驗證是否通過全部(支援 HTML5 驗證者)
reportValidity()檢查並顯示瀏覽器原生提示同上
setCustomValidity(msg)設置自定義錯誤訊息同上
focus()聚焦全部
blur()失焦全部
select()選中文字內容text/password/textarea
labels關聯的 <label> 陣列全部
form所屬 <form> 參考全部

三、表單提交控制

1. 原生提交流程

  • 用戶點擊 <input type="submit">、<button type="submit">、<input type="image">
  • 或在輸入框按 Enter(單行輸入框且表單有提交按鈕)
  • 觸發 form.submit 事件 → 若未阻止 → 向 action 發送 method 請求

2. JS 程式化提交

// 方式 A:觸發原生提交事件(會走驗證、觸發 submit 事件)
form.submit(); // 注意:這不觸發 submit 事件,直接發送
form.requestSubmit(); // 現代 API:觸發 submit 事件並驗證(推薦)

// 方式 B:AJAX 提交(現代標準)
form.addEventListener('submit', function (e) {
  e.preventDefault(); // 阻止頁面跳轉
  var formData = new FormData(form);
  fetch(form.action, { method: form.method, body: formData })
    .then(function (res) { return res.json(); })
    .then(function (data) { console.log('成功', data); })
    .catch(function (err) { console.error('失敗', err); });
});

3. 防止重複提交

form.addEventListener('submit', function (e) {
  var submitBtn = form.querySelector('[type="submit"]');
  if (submitBtn.disabled) {
    e.preventDefault();
    return;
  }
  submitBtn.disabled = true;
  submitBtn.textContent = '提交中...';

  // AJAX 完成後恢復
  fetch(...).finally(function () {
    submitBtn.disabled = false;
    submitBtn.textContent = '提交';
  });
});

4. action="javascript:..." 陷阱

不推薦:<form action="javascript:alert('submitted')"> 違反內容安全策略(CSP),且語義不清。請改用 e.preventDefault() + fetch。

四、完整表單範例(含驗證與無障礙)

<form id="regForm" novalidate> <!-- novalidate 關閉瀏覽器原生提示,改用自定義 -->
  <div class="field">
    <label for="name">姓名</label>
    <input type="text" id="name" name="name" required minlength="2" maxlength="20">
    <span class="error" aria-live="polite"></span>
  </div>

  <div class="field">
    <label for="email">Email</label>
    <input type="email" id="email" name="email" required>
    <span class="error" aria-live="polite"></span>
  </div>

  <fieldset>
    <legend>性別</legend>
    <label><input type="radio" name="gender" value="m" required> 男</label>
    <label><input type="radio" name="gender" value="f"> 女</label>
  </fieldset>

  <div class="field">
    <label for="hobby">興趣</label>
    <select id="hobby" name="hobby" multiple required>
      <option value="code">編程</option>
      <option value="read">閱讀</option>
      <option value="sport">運動</option>
    </select>
    <span class="error" aria-live="polite"></span>
  </div>

  <button type="submit">註冊</button>
  <button type="reset">重置</button>
</form>

<style>
  .field { margin-bottom: 1rem; }
  .field label { display:block; margin-bottom:.3rem; }
  .error { color: #dc3545; font-size: .875rem; min-height: 1.2em; }
  input:invalid, select:invalid { border-color: #dc3545; }
</style>

<script>
var form = document.getElementById('regForm');

form.addEventListener('submit', function (e) {
  e.preventDefault();

  // 1. 原生驗證
  if (!form.checkValidity()) {
    form.reportValidity(); // 顯示原生氣泡(或自定義顯示)
    return;
  }

  // 2. 收集數據
  var data = new FormData(form);
  console.log('提交數據:', Object.fromEntries(data));

  // 3. AJAX ...
  alert('驗證通過,準備發送:' + JSON.stringify(Object.fromEntries(data)));
});

// 即時清除錯誤樣式
form.querySelectorAll('input,select,textarea').forEach(function (el) {
  el.addEventListener('input', function () {
    el.style.borderColor = '';
    var err = el.parentNode.querySelector('.error');
    if (err) err.textContent = '';
  });
});
</script>

五、常見坑與避坑指南

  1. 未關聯 label:務必用 for/id 或包裹結構,否則點擊文字不聚焦、無障礙差
  2. reset 按鈕誤觸:<button> 默認 type="submit",重置按鈕必須寫 type="reset"
  3. disabled **控件不提交**:若需提交不可編輯值,用 readonly 或隱藏域
  4. 檔案上傳:enctype="multipart/form-data" 必須設置,且不可用 application/x-www-form-urlencoded
  5. 巢狀 form 非法:HTML 禁止 <form> 巢狀,瀏覽器會自動修正導致結構錯亂

結語

原生 Form API 配合 FormData、fetch、HTML5 驗證屬性,已能優雅處理絕大多數表單場景。掌握 elements 集合、RadioNodeList.value 神奇語法、requestSubmit() 現代提交方式,能讓代碼更簡潔、更標準、更易維護。

copyright © 萬盛學電腦網 all rights reserved