核心代碼(通用版)
/**
* 重置指定容器內的所有表單字段
* @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];
}
常見坑點
form.reset() 不會清空 input[type=file]、hidden 字段、JS 動態添加的字段
.val('') 不會觸發 change 事件,聯動邏輯會失效,需手動 .trigger('change')
- 美化插件 內部狀態不同步,需調用插件 API
- 動態添加的字段無
defaultValue,重置為空而非初始值