萬盛學電腦網

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

jQuery 自定義事件綁定與觸發完整指南

核心 API

方法用途語法
.on()綁定事件(推薦)$(selector).on('eventName', handler)
.trigger()觸發事件$(selector).trigger('eventName', [data])
.off()解綁事件$(selector).off('eventName', handler)
.one()單次綁定$(selector).one('eventName', handler)

基本用法

// 1. 綁定自定義事件
$('#myElement').on('myCustomEvent', function(e, data) {
    console.log('事件觸發', data);
});

// 2. 觸發事件並傳遞數據
$('#myElement').trigger('myCustomEvent', ['參數1', { key: 'value' }]);

// 3. 命名空間管理(避免衝突)
$('#myElement').on('custom.namespace', handler);
$('#myElement').trigger('custom.namespace');
$('#myElement').off('.namespace'); // 批量解綁

進階場景:組件通信解耦

// 事件總線模式
const EventBus = $({});

// 組件 A 發布事件
EventBus.trigger('user:login', { userId: 123, name: '張三' });

// 組件 B 訂閱事件
EventBus.on('user:login', function(e, userData) {
    updateHeader(userData);
});

// 組件 C 訂閱同一事件
EventBus.on('user:login', function(e, userData) {
    loadUserPreferences(userData.userId);
});

傳遞數據的三種方式

// 方式一:額外參數(推薦)
$el.trigger('event', [arg1, arg2, arg3]);
// handler 接收:function(e, arg1, arg2, arg3)

// 方式二:事件對象屬性
$el.trigger({ type: 'event', customData: { ... } });
// handler 接收:function(e) { e.customData }

// 方式三:triggerHandler(不冒泡、不觸發默認行為)
$el.triggerHandler('event', data);

最佳實踐建議

  1. 命名規範:使用冒號分隔命名空間,如 module:action
  2. 避免濫用:簡單父子通信優先用參數/回調,跨組件才用自定義事件
  3. 內存管理:組件銷毀時調用 .off() 防止內存洩漏
  4. TypeScript 類型:定義事件映射介面提升類型安全

注意:jQuery 3.0+ 棄用 .bind/.live/.delegate

統一使用 .on() / .off(),語法更一致、性能更優。

copyright © 萬盛學電腦網 all rights reserved