| 版本 | 推薦方法 | 狀態 |
|---|---|---|
| < 1.7 | bind() / unbind() | 棄用 |
| 1.7+ | on() / off() | **標準** |
| 3.0+ | on() / off() | bind/unbind 移除 |
本文以現代 on()/off() 為主,兼容說明 unbind()。
// 移除所有事件
$(selector).off();
// 移除特定類型所有處理器
$(selector).off('click');
// 移除特定處理器(需引用)
$(selector).off('click', handlerFn);
// 移除委託事件
$(parent).off('click', '.child', handlerFn);
// 移除帶命名空間的事件
$(selector).off('click.myNamespace');
$('#btn').on('click', fn1).on('click', fn2).on('click', fn3);
$('#removeAll').on('click', function() {
$('#btn').off('click'); // 移除 btn 上所有 click
});
const handler2 = function() { console.log('fn2'); };
$('#btn').on('click', function() { console.log('fn1'); })
.on('click', handler2)
.on('click', function() { console.log('fn3'); });
$('#removeFn2').on('click', function() {
$('#btn').off('click', handler2); // 僅移除 fn2
});
// 綁定時添加命名空間
$('#widget').on('click.widgetA', handlerA);
$('#widget').on('click.widgetA', handlerB);
$('#widget').on('change.widgetB', handlerC);
// 精確移除
$('#widget').off('.widgetA'); // 移除 widgetA 相關所有事件
$('#widget').off('click.widgetA'); // 移除 widgetA 的 click
$('#widget').off('click'); // 移除所有 click(含無命名空間)
// 只觸發一次
$('#btn').one('click', function() {
console.log('只會執行一次');
// 執行完自動 off('click', thisHandler)
});
// 適用場景:引導提示、首次加載數據、防重複提交
$('#submitBtn').one('click', function() {
$(this).prop('disabled', true).text('提交中...');
submitForm().always(() => {
$(this).prop('disabled', false).text('提交');
// 重新綁定 one 以允許再次提交
$(this).one('click', arguments.callee);
});
});
// 委託綁定
$('#list').on('click', '.item', itemClickHandler);
// 移除委託:必須指定相同選擇器
$('#list').off('click', '.item', itemClickHandler);
// 錯誤:不指定選擇器會移除 #list 直接綁定的事件
$('#list').off('click', itemClickHandler); // ❌ 無效
function openModal() {
$('#modal').show();
// 綁定 ESC 關閉、點擊遮罩關閉
$(document).on('keydown.modal', function(e) {
if (e.which === 27) closeModal(); // ESC
});
$('#modalOverlay').on('click.modal', closeModal);
}
function closeModal() {
$('#modal').hide();
// 移除命名空間下所有事件,乾淨利落
$(document).off('.modal');
$('#modalOverlay').off('.modal');
}
// 等價於 off()
$('#btn').unbind('click'); // 移除所有 click
$('#btn').unbind('click', handler); // 移除特定 handler
$('#btn').unbind(); // 移除所有事件
// one() 舊寫法
$('#btn').one('click', handler);
on()/off(),避免混用舊 API.myPlugin),銷毀時 off('.myPlugin') 一鍵清理one(),自動清理destroy() 中清理所有綁定,防內存洩漏掌握事件移除機制,是編寫無內存洩漏、可熱更新、模組化 jQuery 代碼的關鍵。