萬盛學電腦網

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

jQuery 一鍵清空表單查詢條件:input、select、textarea 統一重置

核心代碼(通用版)

/**
 * 重置指定容器內的所有表單字段
 * @param {string|Element|jQuery} container - 表單容器選擇器
 * @param {Object} options - 配置
 */
function resetFormFields(container, options = {}) {
  const $container = $(container);
  const opts = $.extend({
    // 排除不重置的字段(如隱藏的 token、分頁參數)
    exclude: '[data-reset-exclude], [type="hidden"]',
    // 是否觸發 change 事件通知其他監聽器
    triggerChange: true,
    // 自定義重置值映射
    customReset: {}
  }, options);
  
  // 1. 處理 input / textarea
  $container.find('input, textarea').not(opts.exclude).each(function() {
    const $el = $(this);
    const type = this.type.toLowerCase();
    const tag = this.tagName.toLowerCase();
    
    let resetValue = '';
    
    // 自定義重置值優先
    if (opts.customReset[this.name] !== undefined) {
      resetValue = opts.customReset[this.name];
    }
    // 類型特定默認值
    else if (type === 'checkbox' || type === 'radio') {
      this.checked = this.defaultChecked; // 恢復 HTML 初始 checked 狀態
      return; // 跳過後續 val() 設置
    } else if (type === 'file') {
      // file 輸入框無法直接設置 value,需替換元素或用 FormData
      try { this.value = ''; } catch (e) { 
        $el.replaceWith($el.clone(true)); // 克隆替換清空文件選擇
      }
      return;
    } else if (tag === 'textarea') {
      resetValue = this.defaultValue || '';
    } else {
      resetValue = this.defaultValue || '';
    }
    
    // 設置值
    $el.val(resetValue);
    
    // 觸發 change 事件(觸發驗證、聯動等)
    if (opts.triggerChange) $el.trigger('change');
  });
  
  // 2. 處理 select(單選/多選)
  $container.find('select').not(opts.exclude).each(function() {
    const $el = $(this);
    
    // 恢復到默認選中項(HTML 中 selected 屬性的 option)
    $el.find('option').prop('selected', function() {
      return this.defaultSelected;
    });
    
    // 若無默認選中,設置為第一項或空值
    if ($el.val() === '' && $el.find('option[value=""]').length === 0) {
      $el.val($el.find('option:first').val());
    }
    
    if (opts.triggerChange) $el.trigger('change');
  });
  
  // 3. 重置表單驗證狀態(如使用 jQuery Validate)
  if ($.fn.validate) {
    $container.find('form').each(function() {
      const validator = $(this).validate();
      if (validator) validator.resetForm();
    });
  }
}

// 使用示例
$('#reset-btn').click(function() {
  resetFormFields('#query-form', {
    exclude: '[name="page"], [name="pageSize"], [name="token"]',
    customReset: {
      'status': 'all',      // 狀態默認「全部」
      'dateRange': 'week'   // 日期範圍默認「本周」
    }
  });
});

原生 JS 輕量版(無 jQuery 依賴)

function resetFormNative(formElement) {
  const form = formElement instanceof HTMLFormElement 
    ? formElement 
    : formElement.querySelector('form') || formElement;
  
  // 利用原生 reset() 方法(會恢復 defaultValue/defaultChecked)
  form.reset();
  
  // 手動清空 file 類型(reset() 不清空 file)
  form.querySelectorAll('input[type="file"]').forEach(input => {
    try { input.value = ''; } 
    catch (e) { input.replaceWith(input.cloneNode(true)); }
  });
  
  // 觸發 change 事件通知監聽器
  form.querySelectorAll('input, select, textarea').forEach(el => {
    el.dispatchEvent(new Event('change', { bubbles: true }));
  });
}

// 使用
document.getElementById('reset-btn').addEventListener('click', () => {
  resetFormNative('#query-form');
});

進階場景處理

場景處理方案
Select2 / Chosen 等美化插件重置後調用 $select.val(null).trigger('change') 或插件專用方法
日期選擇器調用日期組件的 clear() 或 setDate(null)
級聯下拉(省市區)先重置父級,再遞歸重置子級,或調用業務 resetCascade()
自定義組件約定暴露 reset() 方法,統一調用
保留分頁/排序參數exclude: '[name="page"], [name="sort"], [name="order"]'

Vue/React 框架中處理

// Vue 3 Composition API
function useFormReset(formRef, initialValues) {
  const reset = () => {
    Object.keys(initialValues).forEach(key => {
      formRef.value[key] = initialValues[key];
    });
    // 觸發驗證重置
    formRef.value.clearValidate?.();
  };
  return { reset };
}

// React Hook
function useFormReset(initialValues) {
  const [values, setValues] = useState(initialValues);
  const reset = useCallback(() => setValues(initialValues), [initialValues]);
  return [values, setValues, reset];
}

常見坑點

  1. form.reset() 不會清空 input[type=file]、hidden 字段、JS 動態添加的字段
  2. .val('') 不會觸發 change 事件,聯動邏輯會失效,需手動 .trigger('change')
  3. 美化插件 內部狀態不同步,需調用插件 API
  4. 動態添加的字段無 defaultValue,重置為空而非初始值
copyright © 萬盛學電腦網 all rights reserved