PageRequestManager 是 ASP.NET Ajax 用來管理非同步用戶端操作的核心物件。先前為了避免網頁重複送出的問題,團隊討論後決定用「蓋一層玻璃」的方式,替整個頁面加上透明遮罩,防止使用者重複點擊送出。
因為整個網站是以 ASP.NET Ajax 開發,多數資料更新都透過 UpdatePanel 執行,因此流程中有兩個可以攔截的時機:
在回到伺服器之前,Ajax 會先呼叫 add_beginRequest();等 UpdatePanel 執行完畢後,再呼叫 add_endRequest()。遮罩的建立與取消,就掛在這兩個時機上。
官方範例是這樣寫的:
<script language="javascript" type="text/javascript">
Sys.WebForms.PageRequestManager.getInstance().add_beginRequest(BeginRequestHandler);
Sys.WebForms.PageRequestManager.getInstance().add_endRequest(EndRequestHandler);
function BeginRequestHandler(sender, args) {
var elem = args.get_postBackElement();
ActivateAlertDiv('visible', 'AlertDiv', elem.value + ' processing...');
}
function EndRequestHandler(sender, args) {
ActivateAlertDiv('hidden', 'AlertDiv', '');
}
function ActivateAlertDiv(visstring, elem, msg) {
var adiv = $get(elem);
adiv.style.visibility = visstring;
adiv.innerHTML = msg;
}
</script>
不過若目標是「使用者一按下按鈕就無法再操作」,把效果啟動的時機放在按鈕的 onClientClick 會更即時,再用 add_endRequest 收尾。
一、在頁面上放一個提示用的 div:
<div id="messageElement" class="busybox"
style="font-size: 16px; font-family: Arial, Helvetica, sans-serif;">
<img alt="waiting" src="/App_Themes/images/indicator.gif" />
Please wait a moment...
</div>
二、撰寫 JavaScript。做法是先取得整個 body 的尺寸,把遮罩鋪滿整個視窗,再將提示框置中:
Sys.WebForms.PageRequestManager.getInstance().add_endRequest(EndRequestHandler);
function EndRequestHandler(sender, args) {
showBusyContainer(false);
}
function showBusyContainer(show) {
if (show == true) {
Sys.UI.DomElement.toggleCSSClass(document.body, "HiddenSelect");
var bodyWidth = jQuery("body").outerWidth();
var bodyHeight = Math.max(jQuery("body").outerHeight(), jQuery(window).height());
var boxHeight = jQuery(".busybox").outerHeight();
jQuery(".overlay").show()
.css({ width: bodyWidth, height: bodyHeight });
jQuery(".busybox").show()
.css({
left: (bodyWidth - jQuery(".busybox").width()) / 2,
position: "absolute",
top: bodyHeight / 2 - boxHeight
});
} else {
jQuery(".overlay").hide();
jQuery(".busybox").hide();
jQuery("body").removeClass("HiddenSelect");
}
}
這裡有兩個實務細節值得注意。第一,HiddenSelect 這個 class 通常用來在遮罩期間隱藏 select 元素,因為舊版 IE 的 select 會穿透任何 z-index 設定,蓋不掉。第二,遮罩期間最好同時把焦點或 pointer-events 鎖住,否則鍵盤操作仍可能觸發送出。
更關鍵的一點是:前端遮罩只是使用者體驗,不能當成防禦機制。真正的重複送出防護,仍須在伺服器端加上防護 token 或狀態檢查。