萬盛學電腦網

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

原生 JavaScript 實現遮罩層彈窗登錄框完整教程

遮罩層彈窗是 Web 應用中極常見的交互模式。本文通過完整的原生 JavaScript 實現,深度解析遮罩層創建、彈窗居中定位、拖拽移動、滾動跟隨等核心技術點,幫助您從零構建專業級彈窗組件。

核心 HTML 結構

<body>
  <!-- 遮罩層 -->
  <div id="shade" style="display:none; position:fixed; top:0; left:0; width:100%; height:100%; background:#000; opacity:0.5; z-index:1000;"></div>

  <!-- 觸發按鈕 -->
  <button onclick="showLogin()">登錄</button>

  <!-- 登錄彈窗 -->
  <div id="login" style="display:none; position:fixed; z-index:1001; width:400px; background:#fff; border-radius:8px; box-shadow:0 4px 20px rgba(0,0,0,.2);">
    <div class="login-header" style="padding:16px; border-bottom:1px solid #eee; cursor:move;">
      <h3>用戶登錄</h3>
      <span class="close-btn" onclick="hideLogin()" style="float:right; cursor:pointer;">×</span>
    </div>
    <form id="login-form" style="padding:20px;">
      <div class="form-group">
        <label>用戶名</label>
        <input type="text" name="username" required>
      </div>
      <div class="form-group">
        <label>密碼</label>
        <input type="password" name="password" required>
      </div>
      <button type="submit">登錄</button>
      <button type="button" onclick="hideLogin()">取消</button>
    </form>
  </div>
</body>

核心 JavaScript 實現

1. 彈窗顯示與居中定位

function showLogin() {
    var shade = document.getElementById("shade");
    var login = document.getElementById("login");

    // 顯示遮罩層
    shade.style.display = "block";

    // 彈窗居中顯示
    centerDialog(login);
    login.style.display = "block";
}

function centerDialog(dialog) {
    var w = dialog.offsetWidth;
    var h = dialog.offsetHeight;
    var clientW = document.documentElement.clientWidth;
    var clientH = document.documentElement.clientHeight;

    dialog.style.left = (clientW - w) / 2 + "px";
    dialog.style.top = (clientH - h) / 2 + "px";
}

2. 彈窗拖拽功能

function enableDrag(dialog, handle) {
    var disX = 0, disY = 0;

    handle.onmousedown = function(e) {
        e = e || window.event;
        disX = e.clientX - dialog.offsetLeft;
        disY = e.clientY - dialog.offsetTop;

        document.onmousemove = function(e) {
            e = e || window.event;
            var left = e.clientX - disX;
            var top = e.clientY - disY;

            // 邊界限制
            var maxLeft = document.documentElement.clientWidth - dialog.offsetWidth;
            var maxTop = document.documentElement.clientHeight - dialog.offsetHeight;
            left = Math.max(0, Math.min(left, maxLeft));
            top = Math.max(0, Math.min(top, maxTop));

            dialog.style.left = left + "px";
            dialog.style.top = top + "px";
        };

        document.onmouseup = function() {
            document.onmousemove = null;
            document.onmouseup = null;
        };

        return false; // 防止文字選中
    };
}

// 初始化拖拽
var login = document.getElementById("login");
var header = login.querySelector(".login-header");
enableDrag(login, header);

3. 滾動/縮放時保持居中(解決原文痛點)

// 使用 CSS fixed 定位自動解決滾動跟隨問題
// 關鍵:彈窗使用 position: fixed 而非 absolute
// fixed 定位相對視口,不受頁面滾動影響

// 若必須用 absolute,需監聽滾動事件:
window.addEventListener("scroll", function() {
    if (login.style.display === "block") {
        centerDialog(login);
    }
});

window.addEventListener("resize", function() {
    if (login.style.display === "block") {
        centerDialog(login);
    }
});

關鍵洞察:原文作者使用 `position: absolute` 導致需手動處理滾動跟隨。現代瀏覽器完全支持 `position: fixed`,這是解決該問題的標準方案,無需複雜的定時器或滾動監聽。

4. 關閉彈窗

function hideLogin() {
    document.getElementById("shade").style.display = "none";
    document.getElementById("login").style.display = "none";
}

// ESC 鍵關閉支持
document.addEventListener("keydown", function(e) {
    if (e.key === "Escape") hideLogin();
});

// 點擊遮罩層關閉
document.getElementById("shade").onclick = hideLogin;

現代化改進建議

  • 使用 CSS Transition:添加 `transition: opacity 0.3s, transform 0.3s` 實現平滑彈出動畫
  • Focus Trap:彈窗打開時限制 Tab 鍵在彈窗內循環,符合無障礙標準
  • 模組化封裝:將彈窗邏輯封裝為可復用的 Class 或函數
  • 考慮使用 `` 元素:HTML5 原生對話框元素,語義化且內建無障礙支持
// 原生 dialog 元素簡化實現
<dialog id="login-dialog">
  <form method="dialog">...</form>
</dialog>

<script>
var dialog = document.getElementById("login-dialog");
dialog.showModal(); // 顯示模態框
dialog.close();     // 關閉
</script>

從原生實現到現代標準,理解遮罩層彈窗的核心原理,能讓您在面對各種複雜交互需求時遊刃有餘。

copyright © 萬盛學電腦網 all rights reserved