表單送出、資料上傳這類耗時操作,若沒有任何回饋,使用者往往會以為網頁當掉了而反覆點擊。最通用的解法是蓋上一層半透明遮罩,中間擺一行「請稍候」的提示,請求結束後再移除。
var dates = this.options.form.getWidgetByName("dates").getValue();
$.ajax({
url: "https://127.0.0.1:9009/service/snproduct.do",
data: dates,
beforeSend: function() {
var h = document.body.clientHeight;
$("<div class=\"datagrid-mask\"></div>").css({display:"block",width:"100%",height:h}).appendTo("body");
$("<div class=\"datagrid-mask-msg\"></div>").html("正在上傳生產數據,請稍候。。。").appendTo("body").css({display:"block",
left: ($(document.body).outerWidth(true) - 190) / 2,
top: (h - 45) / 2});
},
complete: function(data) {
$('.datagrid-mask-msg').remove();
$('.datagrid-mask').remove();
},
success: function(data) {
alert("生產數據:"+data);
},
error: function(data) {
alert("上傳生產數據異常!");
}
});
beforeSend 與 complete 成對出現。遮罩在請求前建立、在 regardless 成功或失敗的 complete 中移除,這樣才不會因為一次 error 而永遠卡在遮罩狀態。若只用 success 移除,出錯時頁面就再也點不動了。
置中算法。left 用「視窗寬度減去提示框寬度再除以二」,top 同理。這裡的 190 與 45 分別是提示框的寬與高,換成自己的尺寸時記得同步修改;若提示文字長度不固定,改用負 margin 或 CSS transform 會更穩。
記得搭配 CSS。遮罩要真正阻擋互動,樣式需包含 position:absolute; top:0; left:0; background:#fff; opacity:0.6; filter:alpha(opacity=60); z-index:1000;。少了定位與 z-index,遮罩不會覆蓋整個頁面。
實務上還可加上 timeout 與 beforeSend 回傳 false 取消請求的能力,避免網路異常時遮罩無限等待。