博客 / 詳情

返回

純HTML + CSS + JS 實現Popup彈窗

在 Web 開發中，彈窗（Popup）是一種極其常見的交互組件，廣泛用於：

  • 表單提交確認
  • 刪除操作二次確認
  • 登錄/註冊入口
  • 信息提示或警告

雖然現在有大量 UI 框架（如 Element UI、Ant Design、Bootstrap）提供現成的彈窗組件，但理解其底層實現原理，不僅能讓你在無框架環境下快速構建功能，還能加深對 DOM 操作、事件處理和 CSS 佈局的理解。

本文將基於你提供的代碼片段，從零講解如何用純 HTML/CSS/JS 實現一個專業級的 Popup 彈窗，並擴展出生產環境中的實用技巧。

📌 一、基礎結構解析

popup的彈窗代碼片段

<!-- 蒙版 -->
<div id="mask"></div>

<!-- 彈窗容器 -->
<div id="popup">
  <div class="popup-header">標題</div>
  <div class="popup-body">內容</div>
  <div class="popup-footer">
    <button id="close">關閉</button>
    <button id="confirm">確定</button>
  </div>
</div>

🔍 關鍵設計思想

元素 作用
#mask 半透明遮罩層，阻止用户操作背景頁面
#popup 彈窗主體，居中顯示
.popup-header/body/footer 語義化分區，便於樣式控制

💡 這種“蒙版 + 彈窗”的組合，是實現模態對話框（Modal） 的標準做法。

📌 二、CSS 樣式詳解

2.1 蒙版（Mask）關鍵樣式

#mask {
  position: fixed;        /* 固定定位，脱離文檔流 */
  top: 0; left: 0;
  width: 100%; height: 100%;
  background-color: rgba(0, 0, 0, 0.5); /* 半透黑 */
  display: none;          /* 默認隱藏 */
  z-index: 1000;          /* 層級高於普通內容 */
}
  • position: fixed：確保蒙版始終覆蓋整個視口，即使頁面滾動也不移位。
  • rgba(0,0,0,0.5)：黑色透明度 50%，既遮擋背景又不完全遮蔽。

2.2 彈窗（Popup）居中秘訣

#popup {
  position: fixed;
  top: 50%;
  left: 50%;
  transform: translate(-50%, -50%); /* 精準居中 */
  width: 400px;
  z-index: 1001; /* 高於蒙版 */
}

✅ 為什麼不用 margin: auto？
因為 fixed 定位下 margin: auto 在某些瀏覽器中表現不穩定。
transform: translate(-50%, -50%) 是目前最可靠的垂直+水平居中方案。

📌 三、JavaScript 交互邏輯

// 顯示
btn.addEventListener('click', () => {
  mask.style.display = 'block';
  popup.style.display = 'block';
});

// 關閉（按鈕 + 蒙版點擊）
close.addEventListener('click', hidePopup);
mask.addEventListener('click', hidePopup);

function hidePopup() {
  mask.style.display = 'none';
  popup.style.display = 'none';
}

⚠️ 注意事項

  • 事件委託更優？：此處元素固定，直接綁定即可。
  • 鍵盤支持（ESC 關閉）：生產環境建議加上。

📌 四、升級版：添加 ESC 鍵關閉 & 動畫效果

4.1 支持按 ESC 關閉彈窗

// 新增：監聽鍵盤事件
document.addEventListener('keydown', function(e) {
  if (e.key === 'Escape' && popup.style.display === 'block') {
    hidePopup();
  }
});

4.2 添加淡入淡出動畫（提升用户體驗）

修改 CSS

/* 蒙版動畫 */
#mask {
  opacity: 0;
  transition: opacity 0.3s ease;
}

#mask.show {
  opacity: 1;
}

/* 彈窗動畫 */
#popup {
  opacity: 0;
  transform: translate(-50%, -60%); /* 初始位置略高 */
  transition: all 0.3s ease;
}

#popup.show {
  opacity: 1;
  transform: translate(-50%, -50%);
}

修改 JS

function showPopup() {
  mask.classList.add('show');
  popup.classList.add('show');
  // 必須先設為 block 再加類，否則 transition 不生效
  mask.style.display = 'block';
  popup.style.display = 'block';
}

function hidePopup() {
  mask.classList.remove('show');
  popup.classList.remove('show');
  
  // 動畫結束後再隱藏（避免閃現）
  setTimeout(() => {
    if (!mask.classList.contains('show')) {
      mask.style.display = 'none';
      popup.style.display = 'none';
    }
  }, 300);
}

✅ 動畫原理：通過 opacity 和 transform 實現平滑過渡，比 display 切換更自然。

📌 五、封裝成可複用函數（面向未來）

為了在多個頁面複用，我們可以將其封裝：

function createPopup(title, content, onConfirm) {
  const popup = document.createElement('div');
  popup.innerHTML = `
    <div class="popup-header">${title}</div>
    <div class="popup-body">${content}</div>
    <div class="popup-footer">
      <button class="popup-cancel">取消</button>
      <button class="popup-confirm">確定</button>
    </div>
  `;
  popup.id = 'popup';
  document.body.appendChild(popup);

  // 綁定事件...
}

但更推薦的方式是：將 HTML 結構保留在頁面中，通過 JS 控制顯隱和內容更新，避免重複創建 DOM。

📌 六、生產環境最佳實踐

實踐 説明
✅ 語義化 HTML 使用 <dialog> 標籤（現代瀏覽器支持）更語義化，但兼容性需考慮
✅ 焦點管理 彈窗打開時，將焦點鎖定在彈窗內（防止背景滾動、提升無障礙體驗）
✅ 防止滾動穿透 彈窗開啓時，給 body 添加 overflow: hidden
✅ A11Y 可訪問性 添加 role="dialog"、aria-labelledby 等屬性
✅ 避免 inline style 儘量用 class 切換，而非直接操作 style.display

示例：防止背景滾動

function showPopup() {
  document.body.style.overflow = 'hidden'; // 禁止背景滾動
  mask.style.display = 'block';
  popup.style.display = 'block';
}

function hidePopup() {
  document.body.style.overflow = ''; // 恢復滾動
  mask.style.display = 'none';
  popup.style.display = 'none';
}

完整代碼

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>test popup</title>
    <style>
        /* 蒙版樣式 */
        #mask {
            position: fixed;
            top: 0;
            left: 0;
            width: 100%;
            height: 100%;
            background-color: rgba(0, 0, 0, 0.5);
            display: none;
            z-index: 1000;
        }

        /* 彈窗容器樣式 */
        #popup {
            position: fixed;
            top: 50%;
            left: 50%;
            transform: translate(-50%, -50%);
            width: 400px;
            background-color: white;
            border-radius: 8px;
            box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
            display: none;
            z-index: 1001;
            overflow: hidden;
        }

        /* 彈窗標題部分 */
        .popup-header {
            padding: 16px 20px;
            background-color: #f5f5f5;
            border-bottom: 1px solid #e0e0e0;
            font-size: 18px;
            font-weight: bold;
        }

        /* 彈窗內容部分 */
        .popup-body {
            padding: 20px;
            min-height: 100px;
        }

        /* 彈窗按鈕部分 */
        .popup-footer {
            padding: 16px 20px;
            background-color: #f5f5f5;
            border-top: 1px solid #e0e0e0;
            text-align: right;
        }

        .popup-footer button {
            margin-left: 10px;
            padding: 8px 16px;
            border: 1px solid #ccc;
            border-radius: 4px;
            background-color: #fff;
            cursor: pointer;
        }

        .popup-footer button:hover {
            background-color: #f0f0f0;
        }

        /* 主畫面按鈕樣式 */
        #btn {
            padding: 10px 20px;
            font-size: 16px;
            cursor: pointer;
        }
    </style>
</head>

<body>
<!--主畫面的UI-->
<div>
    <button id="btn">彈窗</button>
</div>

<!--彈窗畫面的UI-->
<div id="mask"></div>
<div id="popup">
    <div class="popup-header">
        彈窗標題
    </div>
    <div class="popup-body">
        <p>這是彈窗的內容區域</p>
    </div>
    <div class="popup-footer">
        <button id="close">關閉</button>
        <button id="confirm">確定</button>
    </div>
</div>

<!--彈窗畫面的UI-->
<script>
    var btn = document.getElementById('btn');
    var mask = document.getElementById('mask');
    var popup = document.getElementById('popup');
    var close = document.getElementById('close');

    // 顯示彈窗
    btn.addEventListener('click', function() {
        mask.style.display = 'block';
        popup.style.display = 'block';
    });

    // 關閉彈窗
    close.addEventListener('click', function() {
        mask.style.display = 'none';
        popup.style.display = 'none';
    });

    // 點擊蒙版關閉彈窗
    mask.addEventListener('click', function() {
        mask.style.display = 'none';
        popup.style.display = 'none';
    });
</script>
</body>
</html>

效果圖

image

✅ 總結

通過本文，你掌握了：

  1. Popup 彈窗的核心結構：蒙版 + 彈窗容器
  2. 精準居中技巧：transform: translate(-50%, -50%)
  3. 交互邏輯實現：顯示/隱藏、蒙版點擊關閉、ESC 鍵支持
  4. 用户體驗優化：淡入淡出動畫、防止滾動穿透
  5. 生產級注意事項：可訪問性、焦點管理、代碼複用

💡 記住：優秀的前端開發，不僅在於“能實現”，更在於“實現得優雅、健壯、可維護”。

前端
user avatar
0 位用戶收藏了這個故事！

發佈 評論

Some HTML is okay.