blockUI 常見的用途有三種:送出 Ajax 請求時顯示遮罩層,避免使用者重複點擊;顯示登入視窗;以及放大檢視圖片。
插件主要提供 blockUI 與 unblockUI 兩個方法來控制彈出層的顯示與隱藏,並可透過參數調整內容、大小與位置。常用參數如下:
message:要顯示的內容,可以是文字、HTML 片段,或用 jQuery 選到的隱藏 div。
css:彈出層本身的樣式,包含位置、尺寸、邊框等。
overlayCSS:遮罩層樣式,例如背景色與透明度。
showOverlay:是否顯示遮罩層,設為 false 可隱藏。
頁面中先引入 jquery.min.js 與 jquery.blockui.js,然後:
$("#btnSubmit").click(function () {
$.blockUI({
message: $("#loginForm"),
css: {
width: '300px',
height: '300px',
left: ($(window).width() - 300) / 2 + 'px',
top: ($(window).height() - 300) / 2 + 'px',
border: 'none'
}
});
});
$("#btnLogin").click(function () {
$.blockUI({
message: "<h2>正在登錄,請稍候……</h2>",
css: {
border: '1px solid black'
}
});
setTimeout(function () { $.unblockUI() }, 1000);
});
$("#btnCancel").click(function () {
$.unblockUI();
});
<div id="loginForm" style="display:none"> <table> <tr> <td>用戶名:</td> <td><input id="txtUserName" type="text" /></td> </tr> <tr> <td>密 碼:</td> <td><input id="txtPwd" type="text" /></td> </tr> <tr> <td><input id="btnLogin" type="button" value="登錄" /></td> <td><input id="btnCancel" type="button" value="取消" /></td> </tr> </table> </div>
三個按鈕示範了典型的三種用法:以隱藏 div 作為內容顯示登入表單、以 HTML 字串搭配 setTimeout 做出「處理中」的過場提示、以及直接關閉遮罩。實務上建議在 Ajax 的 complete 或 error callbacks 中也呼叫一次 unblockUI(),避免請求失敗時遮罩一直擋住頁面。