<form> 在 DOM 中對應 HTMLFormElement,擁有豐富的屬性、方法與集合,是前端數據收集與驗證的中樞。
<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"]');
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');
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> 參考 | 全部 |
<input type="submit">、<button type="submit">、<input type="image">form.submit 事件 → 若未阻止 → 向 action 發送 method 請求// 方式 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); });
});
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 = '提交';
});
});
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>
for/id 或包裹結構,否則點擊文字不聚焦、無障礙差<button> 默認 type="submit",重置按鈕必須寫 type="reset"disabled **控件不提交**:若需提交不可編輯值,用 readonly 或隱藏域enctype="multipart/form-data" 必須設置,且不可用 application/x-www-form-urlencoded<form> 巢狀,瀏覽器會自動修正導致結構錯亂原生 Form API 配合 FormData、fetch、HTML5 驗證屬性,已能優雅處理絕大多數表單場景。掌握 elements 集合、RadioNodeList.value 神奇語法、requestSubmit() 現代提交方式,能讓代碼更簡潔、更標準、更易維護。