萬盛學電腦網

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

JavaScript 實作模態對話框與遮罩層:從零打造可復用彈窗元件

功能需求

  • 半透明遮罩層鎖定背景互動
  • 置中顯示彈窗,支援自訂標題、內容、圖示
  • 提供關閉按鈕、自動關閉計時、ESC 鍵關閉
  • 相容各種螢幕尺寸、捲動情況

CSS 樣式

<style>
/* 遮罩層 */
#blackBg {
  position: fixed; top: 0; left: 0; width: 100%; height: 100%;
  background: #333; opacity: 0.4; z-index: 99999;
  display: none; /* JS 控制顯示 */
}

/* 彈窗容器 */
#H-dialog {
  display: none; position: fixed; z-index: 9999999;
  width: 400px; min-height: 150px; background: #fff;
  border-radius: 8px; box-shadow: 0 4px 20px rgba(0,0,0,0.3);
  font-family: "Microsoft YaHei", sans-serif;
}
#H-dialog .close {
  position: absolute; right: 10px; top: 5px;
  font-size: 28px; line-height: 1; cursor: pointer; color: #999;
}
#H-dialog .close:hover { color: #333; }
#H-dialog .title {
  height: 40px; line-height: 40px; padding: 0 15px;
  font-size: 18px; font-weight: bold; border-bottom: 1px solid #eee;
}
#H-dialog #msgCont {
  padding: 30px 20px 40px 70px; min-height: 36px;
  font-size: 16px; line-height: 1.6;
  background: url('../Images/ui_alert.png') no-repeat 20px center;
}
#H-dialog.success #msgCont {
  background-image: url('../Images/ui_success.png');
}
</style>

HTML 結構

<div id="H-dialog">
  <span class="close" onclick="popupClose(this)">×</span>
  <div class="title">提示</div>
  <div id="msgCont">內容</div>
</div>

核心 JS 邏輯

<script>
// 1. 建立/顯示遮罩層
function lockScreen() {
  if (document.getElementById('blackBg')) return; // 避免重複建立

  var bg = document.createElement('div');
  bg.id = 'blackBg';
  document.body.appendChild(bg);
  // 防止背景捲動
  document.body.style.overflow = 'hidden';
}

// 2. 關閉彈窗與遮罩
function popupClose(el) {
  var bg = document.getElementById('blackBg');
  if (bg) { document.body.removeChild(bg); document.body.style.overflow = ''; }
  var dialog = el.closest('#H-dialog') || el.parentNode;
  dialog.style.display = 'none';
}

// 3. 自動關閉 (預設 2 秒)
function autoClose(dialogId) {
  dialogId = dialogId || 'H-dialog';
  setTimeout(function() {
    var bg = document.getElementById('blackBg');
    if (bg) { document.body.removeChild(bg); document.body.style.overflow = ''; }
    var dialog = document.getElementById(dialogId);
    if (dialog) dialog.style.display = 'none';
  }, 2000);
}

// 4. 核心顯示函式
function showMsg(msg, options) {
  msg = msg || "請重新操作";
  options = options || {};

  var status = options.status || 0;        // 0=提示, 1=成功
  var dialogId = options.dialogId || 'H-dialog';
  var contentId = options.contentId || 'msgCont';

  lockScreen();

  var dialog = document.getElementById(dialogId);
  var content = document.getElementById(contentId);

  // 設定圖示樣式
  dialog.className = status ? 'success' : '';

  // 置中計算 (fixed 定位相對 viewport)
  var vpWidth = window.innerWidth || document.documentElement.clientWidth;
  var vpHeight = window.innerHeight || document.documentElement.clientHeight;
  var scrollLeft = window.pageXOffset || document.documentElement.scrollLeft;
  var scrollTop = window.pageYOffset || document.documentElement.scrollTop;

  // 這裡使用 fixed,所以不需要加 scrollLeft/Top
  dialog.style.left = (vpWidth - 400) / 2 + 'px';
  dialog.style.top = (vpHeight - 200) / 2 + 'px';

  content.innerHTML = msg;
  dialog.style.display = 'block';

  // 自動關閉
  if (options.autoClose !== false) autoClose(dialogId);

  // ESC 關閉
  document.onkeydown = function(e) {
    if (e.key === 'Escape' || e.keyCode === 27) {
      popupClose(dialog.querySelector('.close'));
    }
  };
}

// 使用範例
// showMsg("操作成功!", { status: 1, autoClose: true });
// showMsg("發生錯誤,請重試。", { status: 0, autoClose: false });
</script>

關鍵技術點解析

技術點處理方式
遮罩層建立動態 `createElement`,固定定位覆蓋全視窗,`z-index` 低於彈窗
彈窗置中`position: fixed` + `left: 50%`/`top: 50%` + `transform: translate(-50%, -50%)` (現代寫法)
防止背景捲動`body.style.overflow = 'hidden'` 關閉時恢復
記憶體洩漏防護關閉時 `removeChild` 移除遮罩 DOM,解除事件綁定
多實例支援參數化 `dialogId`/`contentId`,可同時管理多組彈窗

現代化重構建議 (ES6 + CSS Transform)

// CSS
.dialog-overlay { position: fixed; inset: 0; background: rgba(0,0,0,0.4); z-index: 1000; opacity: 0; pointer-events: none; transition: opacity 0.2s; }
.dialog-overlay.show { opacity: 1; pointer-events: auto; }
.dialog-box { position: fixed; left: 50%; top: 50%; transform: translate(-50%, -50%) scale(0.9); z-index: 1001; width: 400px; background: white; border-radius: 8px; opacity: 0; transition: all 0.2s; }
.dialog-overlay.show + .dialog-box { opacity: 1; transform: translate(-50%, -50%) scale(1); }

// JS
class Modal {
  constructor() {
    this.overlay = document.createElement('div');
    this.overlay.className = 'dialog-overlay';
    this.box = document.createElement('div');
    this.box.className = 'dialog-box';
    this.box.innerHTML = '
'; document.body.append(this.overlay, this.box); this.bindEvents(); } bindEvents() { this.overlay.addEventListener('click', () => this.hide()); this.box.querySelector('.close').addEventListener('click', () => this.hide()); document.addEventListener('keydown', e => e.key === 'Escape' && this.hide()); } show({title, content, type='info', autoClose=2000}) { this.box.querySelector('.title').textContent = title; this.box.querySelector('.content').innerHTML = content; this.box.className = 'dialog-box ' + type; this.overlay.classList.add('show'); document.body.style.overflow = 'hidden'; if (autoClose) setTimeout(() => this.hide(), autoClose); } hide() { this.overlay.classList.remove('show'); document.body.style.overflow = ''; } } const modal = new Modal(); // modal.show({title: '成功', content: '資料已儲存', type: 'success'});

從傳統 procedural 寫法進化到 Class-based 元件化,是前端工程化的必經之路。核心邏輯(遮罩、定位、生命週期)保持不變,只是封裝形式更現代化。

copyright © 萬盛學電腦網 all rights reserved