jQuery 允許同一元素同一事件類型綁定多個 handler。重複執行綁定代碼會導致 handler 累積,觸發時全部執行。
// ❌ 錯誤:每次調用綁定一次
function bindClick() {
$('#btn').click(handler);
}
// ✅ 正確:先解綁再綁定
function bindClick() {
$('#btn').off('click').on('click', handler);
// 或舊版:$('#btn').unbind('click').click(handler);
}
// ✅ 只綁定一次在靜態父容器
$('#container').on('click', '.dynamic-btn', handler);
// 動態新增元素自動生效
$('#container').append('');
// 移除委派
$('#container').off('click', '.dynamic-btn', handler);
// ❌ 舊寫法:每次調用在 document 累積
$('.file').live('click', handler);
// ✅ 修復:die() 先移除
$('.file').die('click').live('click', handler);
// ✅ 現代:改用 on() 委派(只執行一次綁定)
$(document).on('click', '.file', handler);
// 只執行一次,自動解綁
$('#btn').one('click', function() {
alert('只彈一次');
});
<div class="box">
<button id="trigger">觸發重複綁定</button>
<br><br>
<button id="test1">click 重複綁定</button>
<button id="test2">off+on 解決</button>
<button id="test3">live 重複綁定</button>
// 綁定時加命名空間
$('#btn').on('click.myModule', handler1);
$('#btn').on('click.validator', handler2);
// 只移除特定模組
$('#btn').off('click.myModule'); // handler1 移除,handler2 保留
// 移除所有 click
$('#btn').off('click');
需要綁定事件
│
├─ 元素是動態新增的? ──是──→ 靜態父容器 .on('event', selector, fn) ──→ 只綁定一次 ✅
│ │
│ 否
│ │
│ └─ 可能重複初始化綁定? ──是──→ .off('event').on('event', fn) ✅
│ │
│ 否
│ │
│ └─ 只需執行一次? ──是──→ .one('event', fn) ✅
│ │
│ 否
│ │
│ └─ 直接 .on('event', fn) ✅
| 場景 | 推薦 API | 關鍵字 |
|---|---|---|
| 靜態元素,可能重複 init | .off('evt').on('evt', fn) | 先解綁 |
| 動態元素 | $(parent).on('evt', selector, fn) | 事件委派 |
| 只執行一次 | .one('evt', fn) | 自動解綁 |
| 模組化管理 | .on('evt.ns', fn) / .off('evt.ns') | 命名空間 |
| 舊版 live 維護 | .die().live() → 遷移至 .on() | 棄用 API |
.on()/.off()