| 方法 | 狀態 | 推薦替代 | 說明 |
|---|---|---|---|
.click(fn) / .bind() | 已棄用 (jQuery 3.0+) | .on('click', fn) | 舊版寫法,內部轉呼叫 .on() |
.live() | 已移除 (jQuery 1.9+) | .on() 事件委派 | 文檔層級委派,效能差 |
.delegate() | 已棄用 (jQuery 3.0+) | .on() 事件委派 | 指定容器委派 |
.on() | ✅ 標準 | - | 統一 API,支援直接綁定、委派、命名空間 |
.off() | ✅ 標準 | - | 解綁,支援命名空間精確移除 |
.one() | ✅ 標準 | - | 只觸發一次自動解綁 |
.trigger() | ✅ 標準 | - | 手動觸發事件 |
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>jQuery 事件綁定示範</title>
<style>
.container { max-width: 700px; margin: 40px auto; padding: 20px; font-family: sans-serif; }
.panel { border: 1px solid #e0e0e0; border-radius: 8px; padding: 20px; margin: 20px 0; background: #fafafa; }
.panel h3 { margin-top: 0; color: #1976d2; }
.btn-group { display: flex; gap: 10px; flex-wrap: wrap; margin: 10px 0; }
button { padding: 8px 16px; background: #1976d2; color: white; border: none; border-radius: 4px; cursor: pointer; }
button.secondary { background: #757575; }
button.danger { background: #e53935; }
button.success { background: #4caf50; }
.log { background: #263238; color: #aed581; padding: 12px; border-radius: 4px; font-family: monospace; font-size: 13px; min-height: 120px; white-space: pre-wrap; }
.target { padding: 20px; background: #e3f2fd; border-radius: 8px; text-align: center; cursor: pointer; user-select: none; }
.target.hover { background: #bbdefb; }
.target.active { background: #1976d2; color: white; }
</style>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
</head>
<body>
<div class="container">
<h2>jQuery 事件系統完整示範</h2>
<div class="panel">
<h3>1. 直接綁定 vs 事件委派</h3>
<div class="btn-group">
<button id="btnDirect">直接綁定 .on('click')</button>
<button id="btnDelegate" class="success">事件委派 .on('click', '.item')</button>
<button id="btnAddItem">動態新增項目</button>
<button id="btnClearDirect" class="danger">解綁直接綁定</button>
<button id="btnClearDelegate" class="danger">解綁委派</button>
</div>
<ul id="listDirect" style="margin:10px 0; padding-left:20px;"></ul>
<ul id="listDelegate" style="margin:10px 0; padding-left:20px;"></ul>
</div>
<div class="panel">
<h3>2. .one() 單次觸發 & .trigger() 手動觸發</h3>
<div class="btn-group">
<button id="btnOne">綁定 .one('click')</button>
<button id="btnTrigger" class="success">.trigger('click') 手動觸發</button>
<button id="btnTriggerCustom" class="secondary">.trigger('customEvent', [data])</button>
</div>
<div id="oneTarget" class="target">點擊我 (僅第一次生效)</div>
</div>
<div class="panel">
<h3>3. 命名空間 .on('click.myPlugin')</h3>
<div class="btn-group">
<button id="btnNsA">綁定 click.pluginA</button>
<button id="btnNsB" class="secondary">綁定 click.pluginB</button>
<button id="btnTriggerNs">觸發 click (全部)</button>
<button id="btnOffNsA" class="danger">解綁 .off('click.pluginA')</button>
<button id="btnOffAll" class="danger">解綁 .off('click') (全部)</button>
</div>
<div id="nsTarget" class="target">命名空間測試區</div>
</div>
<div class="panel">
<h3>4. 事件對象 event 關鍵屬性</h3>
<div id="eventTarget" class="target">點擊/滑鼠移入查看事件資訊</div>
</div>
<div class="log" id="log">事件日誌...</div>
</div>
<script>
$(function() {
const $log = $('#log');
const log = (msg) => $log.prepend(`[${new Date().toLocaleTimeString()}] ${msg}\n`);
let itemCount = 0;
// 1. 直接綁定 vs 委派
$('#btnDirect').on('click', () => {
const $item = $(`項目 ${++itemCount} (直接綁定) `);
$item.on('click', function() { log(`直接綁定: ${$(this).text()}`); });
$('#listDirect').append($item);
log('新增項目並直接綁定 click');
});
$('#btnDelegate').on('click', () => {
$(`項目 ${++itemCount} (委派) `).appendTo('#listDelegate');
log('新增項目 (委派模式無需重新綁定)');
});
// 委派:綁在父層,針對 .item
$('#listDelegate').on('click', '.item', function() {
log(`委派觸發: ${$(this).text()}`);
});
$('#btnAddItem').on('click', () => {
$('#btnDirect, #btnDelegate').trigger('click');
});
$('#btnClearDirect').on('click', () => {
$('#listDirect .item').off('click');
log('已解綁直接綁定的所有項目');
});
$('#btnClearDelegate').on('click', () => {
$('#listDelegate').off('click', '.item');
log('已解綁委派事件');
});
// 2. .one() & .trigger()
$('#btnOne').on('click', () => {
$('#oneTarget').off('click').one('click', function() {
log('.one() 觸發: 只會執行一次');
$(this).text('已觸發,再點無效').removeClass('target').addClass('active');
}).text('點擊我 (僅第一次生效)').removeClass('active').addClass('target');
log('已重新綁定 .one()');
});
$('#btnTrigger').on('click', () => {
$('#oneTarget').trigger('click');
log('.trigger("click") 手動觸發');
});
$('#btnTriggerCustom').on('click', () => {
$('#oneTarget').on('customEvent', (e, data) => {
log(`自定義事件觸發: ${JSON.stringify(data)}`);
}).trigger('customEvent', [{from: 'manual', time: Date.now()}]);
});
// 3. 命名空間
$('#btnNsA').on('click', () => {
$('#nsTarget').on('click.pluginA', () => log('pluginA: click 觸發'));
log('綁定 click.pluginA');
});
$('#btnNsB').on('click', () => {
$('#nsTarget').on('click.pluginB', () => log('pluginB: click 觸發'));
log('綁定 click.pluginB');
});
$('#btnTriggerNs').on('click', () => {
$('#nsTarget').trigger('click');
log('觸發 click (pluginA + pluginB 都會執行)');
});
$('#btnOffNsA').on('click', () => {
$('#nsTarget').off('click.pluginA');
log('解綁 click.pluginA (pluginB 保留)');
});
$('#btnOffAll').on('click', () => {
$('#nsTarget').off('click');
log('解綁所有 click (包含 pluginA, pluginB)');
});
// 4. 事件對象
$('#eventTarget')
.on('click', (e) => log(`click: clientX=${e.clientX}, target=${e.target.tagName}, currentTarget=${e.currentTarget.id}`))
.on('mouseenter', (e) => { $(e.currentTarget).addClass('hover'); log('mouseenter') })
.on('mouseleave', (e) => { $(e.currentTarget).removeClass('hover'); log('mouseleave') })
.on('dblclick', (e) => log(`dblclick: detail=${e.detail}`));
});
</script>
</body>
</html>
// 原理:事件冒泡到父容器,父容器判斷目標是否匹配選擇器
$('#parent').on('click', '.child', handler);
// 等價於原生
document.getElementById('parent').addEventListener('click', e => {
const target = e.target.closest('.child');
if (target && target.parentElement === document.getElementById('parent')) {
handler.call(target, e);
}
});
優勢:動態新增元素自動生效、減少綁定數量 (記憶體)、父容器可靜態存在。
// 綁定
$el.on('click.myPlugin', handler);
$el.on('resize.myPlugin', handler);
$el.on('destroy.myPlugin', cleanup);
// 精確解綁 (不影響其他 click handler)
$el.off('click.myPlugin'); // 只解綁 pluginA 的 click
$el.off('.myPlugin'); // 解綁 pluginA 所有事件
$el.off('click'); // 解綁所有 click (危險!)
最佳實踐:插件/元件開發 必須 使用命名空間,避免污染全域事件。
event 關鍵屬性| 屬性 | 說明 | 常用場景 |
|---|---|---|
type | 事件類型 | 統一處理多種事件 |
target | 觸發事件的原始元素 | 事件委派中識別真實目標 |
currentTarget | 綁定事件的元素 (等同 this) | 委派中獲取容器 |
delegateTarget | 委派綁定的容器元素 | 委派專用 |
which / key / code | 鍵盤按鍵代碼 | 鍵盤快捷鍵 |
pageX / pageY | 相對文檔座標 | 定位浮層、拖曳 |
data | 綁定時傳入的額外資料 | 參數傳遞 |
result | 上一個 handler 的返回值 | 事件管道處理 |
isDefaultPrevented() | 是否調用了 preventDefault() | 檢查預設行為 |
// 綁定時傳資料
$el.on('click', {userId: 123, role: 'admin'}, function(e) {
console.log(e.data.userId); // 123
console.log(e.data.role); // 'admin'
});
// trigger 時傳資料 (陣列會展開為參數)
$el.trigger('customEvent', [arg1, arg2, arg3]);
$el.on('customEvent', (e, arg1, arg2, arg3) => { ... });
$el.on('click', function(e) {
e.preventDefault(); // 阻止預設行為 (a 鏈接跳轉、表單提交等)
e.stopPropagation(); // 阻止冒泡到父元素
e.stopImmediatePropagation(); // 阻止同元素其他 handler 執行
return false; // 等同於 preventDefault() + stopPropagation()
});
.on():直接綁定、委派、命名空間一把抓$staticParent.on('event', '.dynamicSelector', handler).on('click.myWidget', ...).off('click.myWidget') 而非 .off('click').one():自動清理,避免記憶體洩漏.trigger('myEvent', data) + .on('myEvent', handler)e.data / trigger(event, [args])// 直接綁定
el.addEventListener('click', handler, {once: true}); // .one()
// 委派
parent.addEventListener('click', e => {
const target = e.target.closest('.child');
if (target) handler.call(target, e);
});
// 自定義事件
el.dispatchEvent(new CustomEvent('myEvent', {detail: data}));
el.addEventListener('myEvent', e => console.log(e.detail));
jQuery 事件系統以 .on() 為核心,提供了委派、命名空間、單次觸發、手動觸發、資料傳遞等企業級功能。掌握「委派模式」與「命名空間」是編寫可維護、無記憶體洩漏、模組化前端程式碼的關鍵。