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);
<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>

// 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);
}
};
$.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));
$(document).ajaxStart(function() {
if ($.activeRequestCount++ === 0) lockScreen(); // 計數器避免並發閃爍
}).ajaxStop(function() {
if (--$.activeRequestCount === 0) unlockScreen();
}).ajaxError(function() {
if (--$.activeRequestCount === 0) unlockScreen();
});
$.activeRequestCount = 0;
lockScreen: function(message) {
$(".lockDivInfo").html('
' + (message || "處理中...") + '')...
}
doPost 顯式控制ajaxStart/Stop 自動管理$trigger.prop("disabled", true)timeout: 30000,超時自動解鎖並提示role="alert" aria-live="polite"$.fn.doPost 將「請求發起 → 鎖屏 → 響應處理 → 解鎖」封裝為可復用插件,統一了項目中異步交互的體驗標準。理解其「配置合併、狀態管理、生命周期回調」模式,可輕鬆擴展為支持上傳進度、斷點續傳、請求隊列等高級功能的企業級 AJAX 框架。