萬盛學電腦網

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

jQuery 事件綁定完整指南:on/off/one/trigger、事件委派、命名空間、自定義事件實戰

事件綁定 API 演進與現狀

方法狀態推薦替代說明
.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>

    核心概念深度解析

    1. 事件委派原理

    // 原理:事件冒泡到父容器,父容器判斷目標是否匹配選擇器
    $('#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);
      }
    });

    優勢:動態新增元素自動生效、減少綁定數量 (記憶體)、父容器可靜態存在。

    2. 命名空間:模組化事件管理的關鍵

    // 綁定
    $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 (危險!)

    最佳實踐:插件/元件開發 必須 使用命名空間,避免污染全域事件。

    3. 事件對象 event 關鍵屬性

    屬性說明常用場景
    type事件類型統一處理多種事件
    target觸發事件的原始元素事件委派中識別真實目標
    currentTarget綁定事件的元素 (等同 this)委派中獲取容器
    delegateTarget委派綁定的容器元素委派專用
    which / key / code鍵盤按鍵代碼鍵盤快捷鍵
    pageX / pageY相對文檔座標定位浮層、拖曳
    data綁定時傳入的額外資料參數傳遞
    result上一個 handler 的返回值事件管道處理
    isDefaultPrevented()是否調用了 preventDefault()檢查預設行為

    4. 傳遞自定義資料給處理器

    // 綁定時傳資料
    $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) => { ... });

    5. 事件阻止傳播與預設行為

    $el.on('click', function(e) {
      e.preventDefault(); // 阻止預設行為 (a 鏈接跳轉、表單提交等)
      e.stopPropagation(); // 阻止冒泡到父元素
      e.stopImmediatePropagation(); // 阻止同元素其他 handler 執行
      return false; // 等同於 preventDefault() + stopPropagation()
    });

    現代最佳實踐總結

    1. 統一用 .on():直接綁定、委派、命名空間一把抓
    2. 動態內容必用委派:$staticParent.on('event', '.dynamicSelector', handler)
    3. 插件/元件必加命名空間:.on('click.myWidget', ...)
    4. 清理時精確解綁:.off('click.myWidget') 而非 .off('click')
    5. 單次事件用 .one():自動清理,避免記憶體洩漏
    6. 自定義事件解耦元件:.trigger('myEvent', data) + .on('myEvent', handler)
    7. 傳遞資料用 e.data / trigger(event, [args])

    原生 JS 對照 (無依賴趨勢)

    // 直接綁定
    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() 為核心,提供了委派、命名空間、單次觸發、手動觸發、資料傳遞等企業級功能。掌握「委派模式」與「命名空間」是編寫可維護、無記憶體洩漏、模組化前端程式碼的關鍵。

    copyright © 萬盛學電腦網 all rights reserved