萬盛學電腦網

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

jQuery 點擊彈出層外部關閉:stopPropagation 與 document 事件委派

下拉選單、模態框、工具提示等彈出元件常見需求:點擊內部互動不關閉、點擊外部任意處關閉。本文解析核心技巧 stopPropagation() 與事件委派模式。

核心原理

  1. 彈出層綁定 click 事件,呼叫 e.stopPropagation() 阻止事件冒泡到 document
  2. document 綁定 click 事件,檢測彈出層是否可見,可見則隱藏
  3. 利用事件傳播機制:內部點擊→冒泡被阻斷→document 不觸發;外部點擊→直達 document→觸發關閉

完整實作範例

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>點擊外部關閉彈出層</title>
    <style>
        .dropdown { position: relative; display: inline-block; }
        .trigger { padding: 8px 16px; background: #3498db; color: white; cursor: pointer; border: none; }
        .menu { display: none; position: absolute; top: 100%; left: 0; min-width: 200px; background: white; border: 1px solid #ddd; box-shadow: 0 2px 8px rgba(0,0,0,0.15); z-index: 100; }
        .menu.show { display: block; }
        .menu-item { padding: 10px 16px; cursor: pointer; }
        .menu-item:hover { background: #f5f5f5; }
    </style>
</head>
<body>
    <div class="dropdown">
        <button class="trigger" id="trigger">點擊展開選單</button>
        <div class="menu" id="menu">
            <div class="menu-item">選項 1</div>
            <div class="menu-item">選項 2</div>
            <div class="menu-item">選項 3</div>
        </div>
    </div>

    <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
    <script>
        $(function() {
            const $trigger = $('#trigger');
            const $menu = $('#menu');
            
            // 1. 觸發器點擊:切換顯示並阻止冒泡
            $trigger.on('click', function(e) {
                e.stopPropagation(); // 關鍵:阻止事件傳到 document
                $menu.toggleClass('show');
            });
            
            // 2. 選單內部點擊:阻止冒泡(防止點選項目時關閉)
            $menu.on('click', function(e) {
                e.stopPropagation();
            });
            
            // 3. Document 點擊:關閉選單
            $(document).on('click', function() {
                if ($menu.hasClass('show')) {
                    $menu.removeClass('show');
                }
            });
            
            // 進階:ESC 鍵關閉
            $(document).on('keydown', function(e) {
                if (e.key === 'Escape' && $menu.hasClass('show')) {
                    $menu.removeClass('show');
                }
            });
        });
    </script>
</body>
</html>

原生 JS 實作(無 jQuery 依賴)

const trigger = document.getElementById('trigger');
const menu = document.getElementById('menu');

trigger.addEventListener('click', e => {
    e.stopPropagation();
    menu.classList.toggle('show');
});

menu.addEventListener('click', e => e.stopPropagation());

document.addEventListener('click', () => {
    menu.classList.remove('show');
});

// ESC 關閉
document.addEventListener('keydown', e => {
    if (e.key === 'Escape') menu.classList.remove('show');
});

進階:多個彈出層共存管理

class DropdownManager {
    constructor() {
        this.openDropdowns = new Set();
        this.bindDocumentClick();
    }
    
    bindDocumentClick() {
        document.addEventListener('click', () => this.closeAll());
        document.addEventListener('keydown', e => {
            if (e.key === 'Escape') this.closeAll();
        });
    }
    
    register(dropdown) {
        this.openDropdowns.add(dropdown);
        dropdown.element.addEventListener('click', e => e.stopPropagation());
        dropdown.trigger.addEventListener('click', e => {
            e.stopPropagation();
            this.closeOthers(dropdown);
            dropdown.toggle();
        });
    }
    
    closeOthers(except) {
        this.openDropdowns.forEach(d => {
            if (d !== except && d.isOpen) d.close();
        });
    }
    
    closeAll() {
        this.openDropdowns.forEach(d => d.close());
    }
}

// 使用
const manager = new DropdownManager();
document.querySelectorAll('.dropdown').forEach(el => {
    manager.register({
        element: el.querySelector('.menu'),
        trigger: el.querySelector('.trigger'),
        isOpen: false,
        toggle() { this.isOpen = !this.isOpen; this.element.classList.toggle('show', this.isOpen); },
        close() { this.isOpen = false; this.element.classList.remove('show'); }
    });
});

常見坑點

問題原因解決
點擊選單項目選單消失未在選單上阻止冒泡$menu.on('click', e => e.stopPropagation())
觸發器連點兩下才開啟document 點擊先關閉,再觸發器開啟觸發器用 mousedown 或檢查狀態後再 toggle
iframe 內點擊無法關閉事件不跨域冒泡iframe 內也綁定 document.click 並 postMessage 通知父頁
行動裝置觸摸不觸發touch 事件不冒泡到 click同時監聽 touchstart 或用 pointerdown

無障礙增強

  • 添加 aria-expanded、aria-haspopup、role="menu" 等 ARIA 屬性
  • 焦點管理:開啟時焦點移入選單,關閉時回到觸發器
  • 鍵盤導航:支援 Tab、方向鍵、Enter、Esc
copyright © 萬盛學電腦網 all rights reserved