萬盛學電腦網

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

JavaScript 實現模態彈窗與半透明遮罩層:從零構建可復用彈窗組件

模態彈窗是 Web 應用的基礎 UI 組件。本文從零實現一個純 JS + CSS 的模態彈窗,涵蓋居中定位、遮罩層、關閉控制、鍵盤無障礙 (ESC 關閉、焦點陷阱)、動畫過渡、多實例管理,並提供現代化重構方向。

核心 HTML 結構

<!-- 觸發按鈕 -->
<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>

CSS 關鍵樣式

.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; }

JavaScript 核心邏輯 (ES6 Class)

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());

無障礙 (a11y) 關鍵點

多實例管理器

class ModalManager {
  constructor() { this.modals = new Map(); }
  
  register(id, modal) { this.modals.set(id, modal); }
  unregister(id) { this.modals.delete(id); }
  
  open(id) { 
    // 關閉同層級其他彈窗 (可選)
    this.modals.forEach((m, key) => { if (key !== id) m.close(); });
    this.modals.get(id)?.open(); 
  }
  closeAll() { this.modals.forEach(m => m.close()); }
}

const modalManager = new ModalManager();
// 頁面任意處
modalManager.open('loginModal');

現代替代:原生 <dialog> 元素

<dialog id="nativeModal">
  <form method="dialog">
    <h2>原生對話框</h2>
    <p>支援 showModal()、::backdrop、表單 method="dialog" 自動關閉</p>
    <menu><button value="confirm">確定</button></menu>
  </form>
</dialog>

<script>
const dialog = document.getElementById('nativeModal');
document.getElementById('openNative').onclick = () => dialog.showModal();
dialog.addEventListener('close', () => console.log('返回值:', dialog.returnValue));
</script>

✅ 原生支援遮罩 (::backdrop)、焦點管理、ESC 關閉、表單整合
⚠️ Safari 15.4+ 才完整支援,舊專案需 polyfill

總結

  1. 手寫 Modal 類:理解焦點管理、事件綁定、生命週期、a11y 基石
  2. 生產專案:優先用 <dialog> + polyfill,或成熟庫 (Headless UI, Radix UI, React Aria)
  3. 避免:alert/confirm/prompt (無法樣式化、阻塞主執行緒、體驗差)

一個好的彈窗組件,不只是「彈出來」,更在於「如何優雅地進入與退出」。

copyright © 萬盛學電腦網 all rights reserved
屬性/行為作用
role="dialog" + aria-modal="true"告知螢幕閱讀器這是模態對話框
aria-labelledby關聯標題元素,提供語境
焦點陷阱Tab/Shift+Tab 循環在彈窗內,不洩漏到背景
開啟時焦點移入引導螢幕閱讀器用戶進入彈窗上下文
關閉時焦點歸還回到觸發按鈕,保持操作連續性
ESC 關閉符合鍵盤用戶預期