核心 API:.bind() / .on() 的 eventData 參數
// 語法:.on(events, selector, data, handler)
// data 可以是任意類型,在 handler 中通過 event.data 訪問
$('#btn').on('click', { userId: 123, role: 'admin' }, function(e) {
console.log('用戶:', e.data.userId, '角色:', e.data.role);
// 輸出: 用戶: 123 角色: admin
});
兩種綁定模式對比
| 模式 | 語法 | 參數傳遞 | 適用場景 |
| 閉包捕獲 | el.on('click', fn) | 外部變量引用 | 簡單場景、參數固定 |
| eventData 顯式傳遞 | el.on('click', data, fn) | e.data 獲取 | 動態參數、循環綁定、避免閉包陷阱 |
經典閉包陷阱與 eventData 解法
// ❌ 問題:循環中綁定,所有處理器共享同一 i(最終值)
for (var i = 0; i < 3; i++) {
$('#btn' + i).on('click', function() { alert(i); }); // 全彈出 3
}
// ✅ 方案一:eventData 傳遞當前值
for (var i = 0; i < 3; i++) {
$('#btn' + i).on('click', { index: i }, function(e) {
alert(e.data.index); // 正確彈出 0,1,2
});
}
// ✅ 方案二:IIFE 創建新作用域 (ES5)
for (var i = 0; i < 3; i++) {
(function(idx) {
$('#btn' + idx).on('click', function() { alert(idx); });
})(i);
}
// ✅ 方案三:let 塊級作用域 (ES6+)
for (let i = 0; i < 3; i++) {
$('#btn' + i).on('click', function() { alert(i); }); // 正確
}
進階模式:自定義事件 + trigger 傳參
// 1. 定義業務邏輯處理器(接收參數)
function handleUserAction(action, userId, extra) {
console.log('動作:', action, '用戶:', userId, '額外:', extra);
}
// 2. 綁定自定義事件
$('#userList').on('userAction', function(e, action, userId, extra) {
handleUserAction(action, userId, extra);
});
// 3. 任意處觸發,靈活傳參
$('#btnDelete').on('click', function() {
var userId = $(this).data('uid');
$('#userList').trigger('userAction', ['delete', userId, { force: true }]);
});
$('#btnEdit').on('click', function() {
var userId = $(this).data('uid');
$('#userList').trigger('userAction', ['edit', userId]);
});
命名空間事件管理
// 綁定帶命名空間
$('#el').on('click.myModule', { id: 1 }, handler);
$('#el').on('click.otherModule', { id: 2 }, handler);
// 精確解綁
$('#el').off('click.myModule'); // 僅移除 myModule 命名空間下的 click
$('#el').off('.myModule'); // 移除 myModule 所有事件
$('#el').off('click'); // 移除所有 click(慎用)
完整驗證頁
<!DOCTYPE html>
<html><head><meta charset="utf-8"><script src="https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"></script></head><body>
<button id="btn0">按鈕 0</button>
<button id="btn1">按鈕 1</button>
<button id="btn2">按鈕 2</button>
<pre id="log"></pre>
<script>
var $log = $('#log');
function log(msg) { $log.text(msg + '\n' + $log.text().slice(0, 300)); }
// 方案一:eventData
for (var i = 0; i < 3; i++) {
$('#btn' + i).on('click', { index: i }, function(e) {
log('eventData: 按鈕 ' + e.data.index + ' 被點擊');
});
}
// 方案二:trigger 傳參
$('#container').on('customAction', function(e, name, value) {
log('trigger: ' + name + ' = ' + value);
});
$('#triggerBtn').on('click', function() {
$('#container').trigger('customAction', ['測試參數', 12345]);
});
</script>
</body></html>
現代框架對應
| 框架 | 參數傳遞方式 |
| Vue | @click="handle(id, 'edit')" 或 @click="() => handle(id, 'edit')" |
| React | onClick={() => handle(id, 'edit')} 或 onClick={handle.bind(null, id, 'edit')} |
| Svelte | on:click={() => handle(id, 'edit')} |
| Alpine.js | @click="handle(id, 'edit')" |
總結
- eventData:jQuery 獨有機制,解決循環綁定閉包問題,參數靜態確定於綁定時。
- trigger 參數陣列:運行時動態決定參數,適合解耦觸發源與處理邏輯。
- 命名空間:大型項目必備,防止插件間事件衝突,支持精確清理。
- 現代框架均使用箭頭函數/bind在聲明處直接傳參,更直觀、類型友好。