表單元素類型繁多(text、password、textarea、checkbox、radio、select、hidden、file 等),各自重置方式不同:
value = ""checked = falseselectedIndex = -1 或 .val([])value = ""(安全性限制,部分瀏覽器禁止 JS 修改)手寫重置邏輯易漏類型、難維護。本文提供一個健壯的通用 clearForm() 函式。
/**
* 完整清空表單所有輸入元素
* @param {jQuery|Element|string} form - 表單選擇器、jQuery 物件或 DOM 元素
*/
function clearForm(form) {
var $form = $(form);
// 針對表單內所有輸入元素
$form.find(":input").each(function() {
var $el = $(this);
var type = this.type;
var tag = this.tagName.toLowerCase();
try {
// 文字類:text, password, textarea, hidden, email, number, date 等
if (/^(text|password|textarea|hidden|email|number|date|time|tel|url|search|color)$/i.test(type)) {
this.value = "";
}
// 勾選類:checkbox, radio
else if (/^(checkbox|radio)$/i.test(type)) {
this.checked = false;
}
// 下拉選單:select-one, select-multiple
else if (tag === "select") {
this.selectedIndex = -1; // 最相容的寫法
// 現代瀏覽器也可用:$el.val([]) 或 $el.find("option:first").prop("selected", true)
}
// 檔案上傳:無法直接清空,需替換元素
else if (type === "file") {
$el.replaceWith($el.clone(true)); // 保留事件綁定
}
// 按鈕類不處理(submit, reset, button, image)
} catch (e) {
console.warn("清空元素失敗:", this, e);
}
});
// 觸發 change 事件通知其他元件(如驗證插件)
$form.find(":input").trigger("change");
return $form; // 支援鏈式呼叫
}
<form id="userForm">
<input type="text" name="name">
<input type="password" name="pwd">
<textarea name="bio"></textarea>
<input type="checkbox" name="agree">
<select name="city"><option value="1">台北</option></select>
<input type="file" name="avatar">
<button type="button" onclick="clearForm('#userForm')">重置</button>
</form>
$("#userForm").on("submit", function(e) {
e.preventDefault();
var $form = $(this);
$.ajax({
url: "/api/user",
type: "POST",
data: $form.serialize(),
success: function() {
alert("儲存成功");
clearForm($form); // 傳入 jQuery 物件
}
});
});
<!-- 原生 reset:只能回復到載入時的初始值,無法清空預設值 -->
<input type="reset" value="原生重置">
<!-- 自訂清空:完全清空為空值 -->
<button type="button" onclick="clearForm(this.form)">完全清空</button>
// 遞迴清空(處理巢狀 form、fieldset 內的輸入元素)
function deepClearForm(container) {
var $container = $(container);
$container.find("form, fieldset, div").addBack().each(function() {
clearForm(this);
});
}
// 動態新增的表單元素也能清空(事件委派)
$(document).on("click", ".btn-clear-form", function() {
clearForm($(this).closest("form"));
});
HTML5 原生 HTMLFormElement.reset() 可重置為初始值(非清空):
document.getElementById("userForm").reset(); // 回復到 value 預設值
// 若需「完全清空」且不想寫 JS,可將所有 input 移除 value 屬性
// 或在表單提交前用 JS 移除預設值
| 問題 | 原因 | 解決 |
|---|---|---|
| 檔案上傳無法清空 | 瀏覽器安全限制 | 用 replaceWith clone 替換元素 |
| select 不會變回預設選項 | selectedIndex=-1 讓無選中狀態 | 若需預設值:$el.val($el.find("option:first").val()) |
| 隱藏欄位也被清空 | :input 包含 hidden | 加上 .not("[type=hidden]") 排除 |
| 驗證錯誤訊息未清除 | 驗證插件未收到 change 事件 | 手動 trigger("change") 或呼叫插件 reset 方法 |
clearForm() 函式涵蓋所有標準表單元素類型,處理檔案上傳替換、觸發 change 事件、支援鏈式呼叫。建議將其封裝為 jQuery 外掛 $.fn.clearForm = function() { return clearForm(this); },專案中隨時呼叫 $("form").clearForm()。現代專案中,配合 Vue/React 表單狀態管理,清空只需重置資料模型,無需直接操作 DOM。