萬盛學電腦網

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

jQuery 事件移除完全指南:unbind()、off() 與 one() 單次綁定

事件移除方法演進

版本推薦方法狀態
< 1.7bind() / unbind()棄用
1.7+on() / off()**標準**
3.0+on() / off()bind/unbind 移除

本文以現代 on()/off() 為主,兼容說明 unbind()。

off() 方法語法

// 移除所有事件
$(selector).off();

// 移除特定類型所有處理器
$(selector).off('click');

// 移除特定處理器(需引用)
$(selector).off('click', handlerFn);

// 移除委託事件
$(parent).off('click', '.child', handlerFn);

// 移除帶命名空間的事件
$(selector).off('click.myNamespace');

核心示例

1. 移除所有綁定事件

$('#btn').on('click', fn1).on('click', fn2).on('click', fn3);

$('#removeAll').on('click', function() {
    $('#btn').off('click'); // 移除 btn 上所有 click
});

2. 移除特定處理器(需保存引用)

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
});

3. 命名空間管理(推薦插件/模組化)

// 綁定時添加命名空間
$('#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(含無命名空間)

one() - 單次綁定(執行後自動移除)

// 只觸發一次
$('#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');
}

unbind() 兼容寫法(舊代碼維護)

// 等價於 off()
$('#btn').unbind('click');           // 移除所有 click
$('#btn').unbind('click', handler);  // 移除特定 handler
$('#btn').unbind();                  // 移除所有事件

// one() 舊寫法
$('#btn').one('click', handler);

最佳實踐總結

  1. 統一使用 on()/off(),避免混用舊 API
  2. 插件/組件務必使用命名空間(如 .myPlugin),銷毀時 off('.myPlugin') 一鍵清理
  3. 保存處理器引用以便精確移除,避免誤傷
  4. 委託事件移除需匹配選擇器
  5. 單次響應用 one(),自動清理
  6. 組件銷毀時在 destroy() 中清理所有綁定,防內存洩漏

掌握事件移除機制,是編寫無內存洩漏、可熱更新、模組化 jQuery 代碼的關鍵。

copyright © 萬盛學電腦網 all rights reserved