萬盛學電腦網

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

jQuery AJAX 封裝實現鎖屏加載提示:防止重複提交、提升用戶體驗

AJAX 請求期間鎖定頁面(遮罩層 + Loading 圖標),防止用戶重複點擊、操作干擾,是企業級應用標配交互。本文提供基於 jQuery 的 $.fn.doPost 封裝插件,內建鎖屏、異步/同步切換、緩存控制、錯誤統一處理。

插件核心代碼

;(function($) {
    $.fn.doPost = function(settings) {
        // 1. 默認配置合併
        settings = $.extend({
            isAsync: true,        // 是否異步
            type: "post",         // 請求方式
            url: null,            // 請求地址
            dataType: null,       // 預期返回類型
            data: null,           // 發送數據
            success: null,        // 成功回調
            error: defaultError,  // 失敗回調
            isLock: true,         // 是否鎖屏
            isCache: false        // 是否緩存
        }, settings);

        return this.each(function() {
            var $trigger = $(this);
            
            // 2. 鎖屏
            if (settings.isLock) lockScreen();
            
            // 3. 發起 AJAX
            $.ajax({
                async: settings.isAsync,
                type: settings.type,
                url: settings.url,
                dataType: settings.dataType,
                data: settings.data,
                cache: settings.isCache,
                success: function(msg) {
                    if (settings.isLock) unlockScreen();
                    if (settings.success) settings.success(msg);
                },
                error: function(xhr, status, err) {
                    if (settings.isLock) unlockScreen();
                    if (settings.error) settings.error(xhr, status, err);
                }
            });
        });

        // --- 內部鎖屏方法 ---
        function lockScreen() {
            var $lockDiv = $(".lockDiv");
            var $lockInfo = $(".lockDivInfo");
            
            // 懶加載創建 DOM(首次調用時)
            if ($lockDiv.length === 0) {
                $lockDiv = $('
').appendTo("body"); $lockInfo = $('
加載中...
').appendTo("body"); } $lockDiv.css("opacity", 0.5).fadeIn("normal"); // 計算居中位置 var winW = $(window).width(); var winH = $(window).height(); var divW = $lockInfo.outerWidth(); var divH = $lockInfo.outerHeight(); var left = (winW - divW) / 2; var top = (winH - divH) / 2; $lockInfo.css({ position: "absolute", top: top, left: left, "z-index": 11 }).fadeIn("normal"); } function unlockScreen() { $(".lockDivInfo").fadeOut("normal"); $(".lockDiv").fadeOut("normal"); } function defaultError() { alert("操作失敗!"); } }; })(jQuery);

CSS 樣式(鎖屏遮罩 + Loading 圖標)

<style>
.lockDiv {
    width: 100%; height: 100%;
    display: none; z-index: 10;
    background-color: #DFE8F6;
    position: fixed; top: 0; left: 0; /* fixed 覆蓋全視窗 */
}
.lockDivInfo {
    display: none; position: fixed; z-index: 11;
    padding: 20px; background: #fff; border-radius: 4px;
    box-shadow: 0 2px 10px rgba(0,0,0,0.2);
    text-align: center;
}
.lockDivInfo img { vertical-align: middle; }
#CloseDiv { float: right; margin: 10px; cursor: pointer; }
</style>

Loading 圖標

使用示例

// 1. 綁定觸發元素(按鈕/鏈接/表單)
$("#queryBtn").click(function() {
    queryAction.query();
});

var queryAction = {
    query: function() {
        var settings = {
            type: "post",
            url: "selfCheckStatisticAction!findByRegion",
            dataType: "text",
            data: $("#searchForm").serialize(), // 表單序列化
            success: function(html) {
                $("#contentDiv").html(html); // 直接渲染返回片段
            }
            // isLock、error 等使用默認值
        };
        
        // 2. 調用插件
        $("#queryBtn").doPost(settings);
    }
};

進階擴展建議

1. 支持 Promise 鏈式調用


$.fn.doPost = function(settings) {
    var $this = this;
    return new Promise(function(resolve, reject) {
        settings = $.extend({ isLock: true }, settings);
        if (settings.isLock) lockScreen();
        
        $.ajax(settings)
            .done(function(msg) {
                if (settings.isLock) unlockScreen();
                resolve(msg);
            })
            .fail(function(xhr, status, err) {
                if (settings.isLock) unlockScreen();
                reject({xhr, status, err});
            });
    });
};

// 使用
$("#btn").doPost({url: "/api"}).then(html => {
    $("#container").html(html);
}).catch(err => console.error(err));

2. 全局 AJAX 事件統一鎖屏(替代插件調用)


$(document).ajaxStart(function() {
    if ($.activeRequestCount++ === 0) lockScreen(); // 計數器避免並發閃爍
}).ajaxStop(function() {
    if (--$.activeRequestCount === 0) unlockScreen();
}).ajaxError(function() {
    if (--$.activeRequestCount === 0) unlockScreen();
});

$.activeRequestCount = 0;

3. Loading 文案動態化


lockScreen: function(message) {
    $(".lockDivInfo").html('' + (message || "處理中...") + '')...
}

最佳實踐總結

  1. 按鈕級鎖屏:對關鍵操作(提交、支付、刪除)使用 doPost 顯式控制
  2. 全局攔截:通用查詢、列表加載用 ajaxStart/Stop 自動管理
  3. 防重複提交:鎖屏期間禁用觸發按鈕 $trigger.prop("disabled", true)
  4. 超時兜底:AJAX 設置 timeout: 30000,超時自動解鎖並提示
  5. 無障礙:Loading 區域添加 role="alert" aria-live="polite"

結語

$.fn.doPost 將「請求發起 → 鎖屏 → 響應處理 → 解鎖」封裝為可復用插件,統一了項目中異步交互的體驗標準。理解其「配置合併、狀態管理、生命周期回調」模式,可輕鬆擴展為支持上傳進度、斷點續傳、請求隊列等高級功能的企業級 AJAX 框架。

copyright © 萬盛學電腦網 all rights reserved