模態彈窗是 Web 應用的基礎 UI 組件。本文從零實現一個純 JS + CSS 的模態彈窗,涵蓋居中定位、遮罩層、關閉控制、鍵盤無障礙 (ESC 關閉、焦點陷阱)、動畫過渡、多實例管理,並提供現代化重構方向。
<!-- 觸發按鈕 -->
<button id="openModal">開啟彈窗</button>
<!-- 彈窗容器 (初始隱藏) -->
<div class="modal-overlay" id="modalOverlay" role="dialog" aria-modal="true" aria-labelledby="modalTitle">
<div class="modal-container">
<header class="modal-header">
<h2 id="modalTitle">登入騰虎通行證</h2>
<button class="modal-close" aria-label="關閉彈窗">×</button>
</header>
<div class="modal-body">
<form id="loginForm">
<div class="form-group">
<label for="username">用戶名</label>
<input type="text" id="username" name="username" autocomplete="username" required />
</div>
<div class="form-group">
<label for="password">密碼</label>
<input type="password" id="password" name="password" autocomplete="current-password" required />
</div>
<button type="submit" class="btn btn-primary">登入</button>
</form>
</div>
</div>
</div>
.modal-overlay {
position: fixed; inset: 0;
background: rgba(0, 0, 0, 0.5); /* 半透明遮罩 */
display: flex; align-items: center; justify-content: center;
z-index: 1000; opacity: 0; visibility: hidden; transition: opacity 0.2s, visibility 0.2s;
}
.modal-overlay.open { opacity: 1; visibility: visible; }
.modal-container {
background: white; border-radius: 8px; padding: 0; max-width: 400px; width: 90%;
max-height: 90vh; overflow: auto;
transform: scale(0.9); transition: transform 0.2s;
}
.modal-overlay.open .modal-container { transform: scale(1); }
.modal-header { display: flex; justify-content: space-between; align-items: center; padding: 1rem; border-bottom: 1px solid #eee; }
.modal-close { background: none; border: none; font-size: 1.5rem; cursor: pointer; line-height: 1; }
.modal-body { padding: 1rem; }
.form-group { margin-bottom: 1rem; }
.form-group label { display: block; margin-bottom: 0.25rem; font-weight: 500; }
.form-group input { width: 100%; padding: 0.5rem; border: 1px solid #ccc; border-radius: 4px; }
.btn { padding: 0.5rem 1rem; border: none; border-radius: 4px; cursor: pointer; }
.btn-primary { background: #007bff; color: white; }
class Modal {
constructor(overlaySelector) {
this.overlay = document.querySelector(overlaySelector);
this.container = this.overlay.querySelector('.modal-container');
this.closeBtn = this.overlay.querySelector('.modal-close');
this._focusStack = []; // 焦點堆疊
this._boundHandlers = {}; // 綁定的事件處理器引用
this._initEvents();
}
_initEvents() {
// 關閉按鈕
this._boundHandlers.close = () => this.close();
this.closeBtn.addEventListener('click', this._boundHandlers.close);
// 遮罩點擊關閉 (可選)
this._boundHandlers.overlayClick = (e) => {
if (e.target === this.overlay) this.close();
};
this.overlay.addEventListener('click', this._boundHandlers.overlayClick);
// ESC 鍵關閉
this._boundHandlers.keydown = (e) => {
if (e.key === 'Escape') this.close();
};
// 焦點陷阱
this._boundHandlers.focusin = (e) => this._trapFocus(e);
}
open() {
// 保存當前焦點
this._lastFocused = document.activeElement;
// 開啟動畫
this.overlay.classList.add('open');
document.body.style.overflow = 'hidden'; // 防止背景滾動
// 焦點移至首個可聚焦元素
setTimeout(() => this._trapFocusInit(), 0);
// 註冊全域事件
document.addEventListener('keydown', this._boundHandlers.keydown);
document.addEventListener('focusin', this._boundHandlers.focusin);
}
close() {
this.overlay.classList.remove('open');
document.body.style.overflow = '';
// 移除全域事件
document.removeEventListener('keydown', this._boundHandlers.keydown);
document.removeEventListener('focusin', this._boundHandlers.focusin);
// 歸還焦點
this._lastFocused?.focus();
}
_trapFocusInit() {
const focusables = this.container.querySelectorAll(
'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])'
);
this._firstFocusable = focusables[0];
this._lastFocusable = focusables[focusables.length - 1];
this._firstFocusable?.focus();
}
_trapFocus(e) {
if (!this.overlay.classList.contains('open')) return;
if (e.target === this._lastFocusable && !e.shiftKey) {
e.preventDefault(); this._firstFocusable?.focus();
} else if (e.target === this._firstFocusable && e.shiftKey) {
e.preventDefault(); this._lastFocusable?.focus();
}
}
destroy() {
this.close();
this.closeBtn.removeEventListener('click', this._boundHandlers.close);
this.overlay.removeEventListener('click', this._boundHandlers.overlayClick);
}
}
// 使用
const modal = new Modal('#modalOverlay');
document.getElementById('openModal').addEventListener('click', () => modal.open());
| 屬性/行為 | 作用 |
|---|---|
role="dialog" + aria-modal="true" | 告知螢幕閱讀器這是模態對話框 |
aria-labelledby | 關聯標題元素,提供語境 |
| 焦點陷阱 | Tab/Shift+Tab 循環在彈窗內,不洩漏到背景 |
| 開啟時焦點移入 | 引導螢幕閱讀器用戶進入彈窗上下文 |
| 關閉時焦點歸還 | 回到觸發按鈕,保持操作連續性 |
| ESC 關閉 | 符合鍵盤用戶預期 |