萬盛學電腦網

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

jQuery 一鍵清空表單完整實作:支援所有輸入類型與巢狀結構

為什麼需要專門的清空函式?

表單元素類型繁多(text、password、textarea、checkbox、radio、select、hidden、file 等),各自重置方式不同:

  • 文字類:value = ""
  • 勾選類:checked = false
  • 下拉選單:selectedIndex = -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>

搭配 AJAX 提交後清空

$("#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 物件
    }
  });
});

重置按鈕原生行為 vs 自訂清空

<!-- 原生 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。

copyright © 萬盛學電腦網 all rights reserved