核心誤區
許多開發者以為 <input type="reset"> 或 form.reset() 是「清空表單」,實際上是 **將所有表單控制項的值重置為其 value 屬性 (或 defaultValue) 的初始值**。
W3C 規範定義
「當重置按鈕被點擊,包含它的表單中所有輸入元素的值都重置為它們的預設值。預設值由 HTML value 屬性或 JavaScript 的 defaultValue 屬性指定。」
實測驗證
<form id="testForm">
<input name="username" value="預設帳號">
<input name="email" value=""> <!-- 初始為空 -->
<textarea name="bio">預設簡介</textarea>
<select name="role">
<option value="1" selected>管理員</option>
<option value="2">一般用戶</option>
</select>
<input type="checkbox" name="agree" value="1" checked>
<input type="reset" value="重置">
</form>
<script>
document.getElementById('testForm').addEventListener('reset', function(e) {
console.log('reset 事件觸發');
// 此時值已重置為初始值
});
</script>
操作過程
- 使用者修改:username →
"自訂帳號",email → "test@test.com",取消勾選 agree。
- 點擊「重置」按鈕。
- 結果:username 變回
"預設帳號",email 變回 "" (空字串),bio 變回 "預設簡介",role 回到「管理員」,agree 重新勾選。
實務痛點:動態載入資料編輯表單
場景:使用者點擊「編輯」,AJAX 取得資料填入表單,此時 input.value 已被 JS 覆寫,**但 defaultValue 仍是 HTML 原始值**。若使用者點「重置」,表單會跳回「原始空白/預設值」,而非「剛載入的資料」。
解決方案:同步更新 defaultValue / defaultChecked / defaultSelected
function populateForm(form, data) {
for (var key in data) {
var control = form.elements[key];
if (!control) continue;
if (control.type === 'checkbox' || control.type === 'radio') {
control.checked = control.defaultChecked = (data[key] == control.value);
} else if (control.tagName === 'SELECT') {
control.value = data[key];
// 更新所有 option 的 defaultSelected
Array.from(control.options).forEach(opt => {
opt.defaultSelected = (opt.value == data[key]);
});
} else {
control.value = control.defaultValue = data[key];
}
}
}
// 使用
fetch('/api/user/1').then(r => r.json()).then(data => {
populateForm(document.getElementById('editForm'), data);
});
替代方案:JS 手動清空 (真正的「清空」)
function clearForm(form) {
Array.from(form.elements).forEach(el => {
switch (el.type) {
case 'text': case 'textarea': case 'password': case 'email': case 'number':
case 'hidden': case 'date': case 'tel': case 'url': case 'search':
el.value = '';
break;
case 'checkbox': case 'radio':
el.checked = false;
break;
case 'select-one': case 'select-multiple':
el.selectedIndex = -1;
break;
case 'file':
// 安全限制無法直接清空,需替換元素
var clone = el.cloneNode(true);
el.parentNode.replaceChild(clone, el);
break;
}
});
}
總結對照表
| 需求 | 方法 | 行為 |
| 重置為「初始載入值」 | 更新 defaultValue 後用 form.reset() | 標準、保留瀏覽器原生行為、可被 reset 事件攔截 |
| 重置為「空白/預設狀態」 | clearForm(form) 手動迴圈 | 完全控制、適用動態表單、需自行處理檔案輸入 |
| 只重置特定欄位 | 手動設定 el.value = el.defaultValue | 彈性最高 |