下拉選單、模態框、工具提示等彈出元件常見需求:點擊內部互動不關閉、點擊外部任意處關閉。本文解析核心技巧 stopPropagation() 與事件委派模式。
click 事件,呼叫 e.stopPropagation() 阻止事件冒泡到 documentdocument 綁定 click 事件,檢測彈出層是否可見,可見則隱藏<!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>
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 屬性