萬盛學電腦網

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

jQuery 事件冒泡與捕獲完整指南:stopPropagation、preventDefault 與實戰

什麼是事件冒泡?

當一個元素觸發事件(如 click)時,該事件會**沿著 DOM 樹向上傳播**,依次觸發所有祖先元素上綁定的同類事件處理器。就像氣泡從水底上升到水面。

冒泡順序示例

<div id="outer">
    <div id="middle">
        <span id="inner">點擊我</span>
    </div>
</div>

$('#inner, #middle, #outer, body').on('click', function(e) {
    console.log(this.id || 'body', '觸發');
});

// 點擊 #inner 輸出順序:
// inner → middle → outer → body

事件對象 event 統一封裝

jQuery 統一了跨瀏覽器的事件對象,關鍵屬性/方法:

$(selector).on('click', function(event) {
    event.type;           // "click"
    event.target;         // 觸發事件的最內層元素
    event.currentTarget;  // 綁定事件的元素 (=== this)
    event.delegateTarget; // 委託綁定的元素
    event.which;          // 鍵碼/鼠標鍵
    event.pageX/Y;        // 相對文檔座標
    event.data;           // 綁定時傳遞的數據
    event.timeStamp;      // 觸發時間戳
});

停止冒泡:stopPropagation()

$('#inner').on('click', function(event) {
    console.log('inner clicked');
    event.stopPropagation(); // 阻止向上傳播
});

$('#middle').on('click', function() {
    console.log('middle clicked'); // 不會執行
});

阻止默認行為:preventDefault()

某些元素有瀏覽器默認行為:

  • <a> - 跳轉鏈接
  • <form> - 提交表單
  • <input type="submit"> - 提交表單
  • <input type="text"> - 文字選中/編輯
// 阻止鏈接跳轉
$('a.external').on('click', function(event) {
    event.preventDefault();
    const href = this.href;
    // 執行 AJAX、彈窗確認等
    if (confirm('離開本頁?')) window.location.href = href;
});

// 表單驗證阻止提交
$('#myForm').on('submit', function(event) {
    if (!validateForm()) {
        event.preventDefault(); // 阻止表單提交
        showError('請檢查輸入');
    }
});

同時阻止冒泡與默認行為:return false

在 jQuery 事件處理器中 return false 等價於:

event.stopPropagation();
event.preventDefault();
// 兩種寫法等價
$('a').on('click', function(event) {
    event.preventDefault();
    event.stopPropagation();
});

$('a').on('click', function() {
    return false; // 更簡潔
});

事件捕獲(捕獲階段)

事件流三階段:

  1. 捕獲階段:從 window 向下到目標元素
  2. 目標階段:到達目標元素
  3. 冒泡階段:從目標元素向上到 window
// 原生 JS 開啟捕獲階段監聽(第三個參數 true)
document.getElementById('outer').addEventListener('click', function() {
    console.log('捕獲階段: outer');
}, true); // true = 捕獲階段

// jQuery 不直接支持捕獲階段綁定
// 若需捕獲,請使用原生 addEventListener

注意:jQuery 所有綁定默認在**冒泡階段**。捕獲階段較少用,但可用於:全局攔截、性能分析、安全過濾。

事件委託:利用冒泡機制

將事件綁定在**父元素**,利用冒泡處理子元素(含動態添加)事件:

// ❌ 差:為每個 li 綁定(數量大、動態新增無效)
$('#list li').on('click', handler);

// ✅ 好:委託給 ul(一個綁定、動態有效、性能好)
$('#list').on('click', 'li', function(event) {
    // this 指向被點擊的 li
    // event.target 可能是 li 內部元素
    console.log('點擊了:', this.textContent);
});

實戰案例:下拉選單點擊外部關閉

$(function() {
    const $dropdown = $('.dropdown');
    const $trigger = $('.dropdown-trigger');
    const $menu = $('.dropdown-menu');
    
    $trigger.on('click', function(event) {
        event.stopPropagation(); // 阻止冒泡到 document
        $dropdown.toggleClass('open');
    });
    
    $menu.on('click', function(event) {
        event.stopPropagation(); // 菜單內點擊不關閉
    });
    
    $(document).on('click', function() {
        $dropdown.removeClass('open'); // 點擊其他地方關閉
    });
});

常見誤區

  1. 在非冒泡事件上用 stopPropagation:focus、blur、load、mouseenter/leave 不冒泡,調用無效
  2. 阻止冒泡導致委託失效:子元素調用 stopPropagation() 會阻止父元素委託處理器觸發
  3. 混淆 target/currentTarget:委託中 this/currentTarget 是委託元素,target 是真實觸發元素

總結

  • 冒泡是默認行為,利用委託提升性能、支持動態元素
  • stopPropagation() 截斷冒泡,preventDefault() 取消默認行為
  • jQuery 處理器 return false = 兩者皆執行
  • 捕獲階段 jQuery 不直接支持,需原生 addEventListener(..., true)
  • 理解事件流是編寫健壯交互邏輯的前提
copyright © 萬盛學電腦網 all rights reserved