本文示範如何封裝 jQuery 的 $.ajax,加入「鎖屏」功能:在請求進行中顯示遮罩與提示,請求完成後自動解除,避免使用者重複操作。
/**
* 對 jQuery 的 $.ajax 進行封裝,加入鎖屏功能
* isAsync 是否為異步請求,預設 true
* isLock 是否鎖屏,預設 true
* isCache 是否從瀏覽器快取載入,預設 false
*/
;(function($) {
$.fn.doPost = function(settings) {
settings = jQuery.extend({
isAsync : true,
type : "post",
url : null,
dataType: null,
data : null,
success : null,
error : toError,
isLock : true,
isCache : false
}, settings);
$(this).each(function(){
if(settings.isLock){
lockSrc();
}
$.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){
unlockSrc();
}
settings.success(msg);
},
error : settings.error
});
});
// 鎖屏方法
function lockSrc(){
$(".lockDiv").css({"opacity":"0.5"}).fadeIn('normal');
var scrollWidth = document.documentElement.clientWidth;
var scrollHeight = document.documentElement.clientHeight;
var divWidth = $(".lockDivInfo").width();
var divHeight = $(".lockDivInfo").height();
var divLeft = scrollWidth/2 - divWidth/2;
var divTop = scrollHeight/2 - divHeight/2;
$(".lockDivInfo").css({
"position":"absolute", "top":divTop, "left":divLeft
}).fadeIn('normal');
}
// 解屏方法
function unlockSrc(){
$(".lockDivInfo").fadeOut('normal');
$(".lockDiv").fadeOut('normal');
}
function toError(){
alert("操作失敗!");
}
};
})(jQuery);
.lockDiv {
width: 100%; height: 100%; display: none; z-index: 10;
background-color: #DFE8F6; position: absolute; top: 0px; left: 0px;
}
.lockDivInfo {
width: 50px; height: 2px; display: none; position: absolute;
left: 0px; top: 0px; z-index: 11;
}

// 查詢
$("#queryBtn").click(function(){
selecCheckByRegionApp.query();
});
var selecCheckByRegionApp = {};
selecCheckByRegionApp.query = function(){
var settion = {
type: "post",
url : 'selfCheckStatisticAction!findByRegion',
dataType: "text",
data: $("#searchForm").formSerialize(),
success: function(msg){
$("#contentDiv").html(msg);
}
};
$("#queryBtn").doPost(settion);
};
如此一來,只要呼叫 doPost 並傳入設定,就能在後台請求期間自動鎖定畫面,完成後再解除,讓操作體驗更順暢。