萬盛學電腦網

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

JavaScript 遮罩層與 Loading 提示元件完整實作

前言

在 AJAX 請求或長時間運算時,顯示半透明遮罩層搭配 Loading 圖示,能有效防止使用者重複操作並提升體驗。本文提供一套可直接復用的 showLoad() / closeLoad() 函數,支援 IE6+ 及現代瀏覽器,含遮罩層自動建立、置中計算、關閉清理。

核心功能

  • showLoad(tipInfo):建立提示框、計算置中座標、顯示遮罩層、支援自訂提示文字。
  • closeLoad():隱藏提示框與遮罩層,釋放 IE6 下的 select 遮擋修復。
  • ShowMark() / HideMark():遮罩層單例模式,自動插入 <div id="xp_mark"> 並處理透明度相容性。

完整 JS 代碼(模組化重構)

const LoadingMask = (function() {
    const $body = $("body");
    let $tipDiv, $mask;

    function createTip() {
        $tipDiv = $("");
        $body.append($tipDiv);
    }

    function createMask() {
        $mask = $("");
        // IE8 以下 fallback
        if (!("opacity" in $mask[0].style)) {
            $mask.css("filter", "alpha(opacity=50)");
        }
        $body.append($mask);
    }

    function center($el) {
        const w = $el.outerWidth(), h = $el.outerHeight();
        const winW = $(window).width(), winH = $(window).height();
        const scrollL = $(window).scrollLeft(), scrollT = $(window).scrollTop();
        $el.css({ left: (winW - w)/2 + scrollL, top: (winH - h)/2 + scrollT });
    }

    return {
        show: function(text) {
            if (!$tipDiv) createTip();
            if (!$mask) createMask();

            $tipDiv.html(` ${text}`).show();
            center($tipDiv);
            $mask.show();

            // 捲動/視窗變化時重新置中
            $(window).off("resize.scroll load.scroll").on("resize.scroll load.scroll", () => center($tipDiv));
        },
        hide: function() {
            $tipDiv?.hide();
            $mask?.hide();
            $(window).off("resize.scroll load.scroll");
        }
    };
})();

// 使用範例
$("#btnSubmit").click(function() {
    LoadingMask.show("資料處理中,請稍候...");
    $.post("/api/save", {data: "..."}, function() {
        LoadingMask.hide();
        alert("完成");
    });
});

原版相容性代碼(保留供舊專案參考)

function showLoad(tipInfo) {
    var eTip = document.createElement('div');
    eTip.id = 'tipDiv';
    eTip.style.cssText = 'position:absolute;display:none;padding:5px 15px;background:#4B981D;color:#fff;z-index:99;border:1px solid #D1D1D1;';
    eTip.innerHTML = " " + tipInfo + "";
    document.body.appendChild(eTip);
    $("#tipDiv").css("float", "right"); // 原代碼殘留,建議移除
    centerAndShow();
    ShowMark();
}

function closeLoad() { $('#tipDiv').hide(); HideMark(); }

function ShowMark() {
    var xp_mark = document.getElementById("xp_mark");
    if (!xp_mark) {
        $("body").prepend("");
        ShowMark(); return;
    }
    xp_mark.style.cssText = 'left:0;top:0;position:absolute;background:#000;z-index:1;width:100%;height:100%;display:block;';
    if (document.all) {
        xp_mark.style.filter = "alpha(opacity=50)";
        var ieVer = navigator.appVersion.substr(22,1);
        if (ieVer == 6 || ieVer == 5) hideSelectBoxes();
    } else { xp_mark.style.opacity = "0.5"; }
}

function HideMark() {
    var xp_mark = document.getElementById("xp_mark");
    if (xp_mark) xp_mark.style.display = "none";
    var ieVer = navigator.appVersion.substr(22,1);
    if (ieVer == 6 || ieVer == 5) showSelectBoxes();
}

CSS 建議

#xp_mark { position: fixed; top: 0; left: 0; width: 100%; height: 100%; background: #000; opacity: 0.5; z-index: 9998; display: none; }
#tipDiv  { position: fixed; z-index: 9999; padding: 15px 30px; background: #333; color: #fff; border-radius: 4px; display: none; }
#tipDiv img { vertical-align: middle; margin-right: 8px; }

注意事項

  • 原代碼使用 position:absolute 需手動計算捲軸偏移;現代瀏覽器建議改用 position:fixed 簡化置中邏輯。
  • IE6 需隱藏 select 元素避免穿透,現代專案通常已放棄 IE6 支援。
  • 避免重複建立 DOM,採用單例模式或檢查是否存在再建立。
copyright © 萬盛學電腦網 all rights reserved