有了遮罩層之後,下一步自然是「置中的彈出視窗」。這裡示範一個 Q.Panel,負責定位、淡入淡出、視窗 resize 與捲動時的重新置中,並可選擇是否搭配遮罩形成模態效果。
/*
* 彈出視窗置中於瀏覽器
* 1. show(options{
* height: 高度
* width: 寬度
* speed: 漸顯時間,預設 0
* container: 包含 html 內容的 jQuery 物件
* model: 是否為模態視窗,預設 true
* })
* 2. close(speed: 淡出時間,預設 0)
*/
Q.Panel = function() {
var self = this;
self._resetPosition = function() {
self._container.css("top", self._getTop());
self._container.css("left", self._getLeft());
};
// 垂直置中:捲動量 + (視窗高 - 元素高) / 2
self._getTop = function() {
return Q.bom.scrollY() + (Q.bom.windowHeight() - self._options.height) / 2;
};
// 水平置中:(頁寬 - 元素寬) / 2
self._getLeft = function() {
return (Q.dom.pageWidth() - self._options.width) / 2;
};
self.show = function(options) {
self._options = $.extend({
width: 350, height: 200, opacity: 0.5,
model: true, speed: 0
}, options || {});
self._container = self._options.container;
var css = {
'width': self._options.width,
'height': self._options.height,
'z-index': Q.Overlay.zindex,
'position': 'absolute',
'left': self._getLeft(),
'top': self._getTop(),
'display': 'none'
};
self._container.css(css);
if (self._options.model) {
self._overlay = new Q.Overlay(self._options.opacity);
self._overlay.show();
}
// 視窗尺寸或捲動位置改變時重新置中
$(window).scroll(self._resetPosition);
$(window).resize(self._resetPosition);
$(document.body).append(self._container);
self._container.fadeIn(self._options.speed);
Q.Overlay.zindex++; // 每開一次就遞增,避免多層重疊時被蓋住
};
self.close = function(speed) {
$(window).unbind('resize', self._resetPosition);
$(window).unbind('scroll', self._resetPosition);
self._container.fadeOut(speed || 0, function() {
self._container.remove();
if (self._options.model) self._overlay.close();
});
};
};
很多人寫置中只算 (視窗高 − 元素高) / 2,結果頁面一捲動,彈窗就跑到上面去了。原因是 position: absolute 的定位基準是文件而非視窗,因此垂直方向必須再加上目前的 scrollTop——這就是 _getTop 裡 Q.bom.scrollY() 的作用。水平方向則不受捲動影響,直接除以二即可。
另外,記得在 close 時把 scroll 與 resize 這兩個監聽解除。否則關掉之後,每次捲動都會去對一個已經從 DOM 移除的節點設定樣式,白白浪費效能。
1. 彈出自訂的隱藏容器
<div id="league" style="display:none">
<button class="close">close</button>
</div>
Q.showPanel("league", function(panel, container) {
container.find(".close").click(function() { panel.close(); });
});
Q.showPanel = function(containerId, registerEventCallback) {
var container = $("#" + containerId);
var height = container.height();
var width = container.width();
container = container.clone(true); // 複製節點與事件
var options = { height: height, width: width, container: container };
var panel = new Q.Panel();
registerEventCallback(panel, container);
panel.show(options);
};
2. 從 URL 載入片段
Q.openWindow = function(url, data, registerEventCallback) {
$.get(url, data, function(html) {
var panelDiv = $(html);
panelDiv.hide();
$(document.body).append(panelDiv);
var options = { height: panelDiv.height(), width: panelDiv.width(),
container: panelDiv };
var panel = new Q.Panel();
registerEventCallback(panel, panelDiv);
panel.show(options);
});
};
3. 三秒後自動淡出的提示框
Q.tips = function(msg) {
var html = '<div class="gu_layer w330">' +
'<div class="gu_layer_main">' +
'<h2>提示</h2>' +
'<p class="gu_layer_txt">' + msg + '</p>' +
'<div class="gu_layer_btn"></div>' +
'</div></div>';
var container = $(html);
container.hide();
$(document.body).append(container);
var panel = new Q.Panel();
panel.show({ container: container, height: container.height(),
width: container.width(), speed: 500 });
setTimeout(function() { panel.close(500); }, 3000);
};
4. 警告與確認框
Q.alert = function(msg) {
var html = '<div class="gu_layer w330">' +
'<div class="gu_layer_main">' +
'<h2><a class="btn_tit_close" href="">關閉</a>提示</h2>' +
'<p class="gu_layer_txt">' + msg + '</p>' +
'<div class="gu_layer_btn">' +
'<a class="btn_org" href="">確 定</a></div>' +
'</div></div>';
var container = $(html);
container.hide();
$(document.body).append(container);
var panel = new Q.Panel();
container.find(".btn_tit_close").click(function() { panel.close(); return false; });
container.find(".btn_org").click(function() { panel.close(); return false; });
panel.show({ container: container, height: container.height(),
width: container.width() });
};
/* 確認框,cancel 回呼為可選 */
Q.confirm = function(title, msg, yes, cancel) {
var html = '<div class="gu_layer w330">' +
'<div class="gu_layer_main">' +
'<h2><a class="btn_tit_close" href="">關閉</a>' + title + '</h2>' +
'<p class="gu_layer_txt">' + msg + '</p>' +
'<div class="gu_layer_btn">' +
'<a class="btn_org" href="">確 定</a>' +
'<a class="btn_gray" href="">取 消</a></div>' +
'</div></div>';
var container = $(html);
container.hide();
$(document.body).append(container);
var panel = new Q.Panel();
container.find(".btn_tit_close").click(function() { panel.close(); return false; });
container.find(".btn_gray").click(function() {
if (cancel) cancel();
panel.close();
return false;
});
container.find(".btn_org").click(function() {
if (yes) yes();
panel.close();
return false;
});
panel.show({ container: container, height: container.height(),
width: container.width() });
};
把「怎麼置中、怎麼淡入、怎麼收」收在 Panel 裡,把「長什麼樣、綁哪些按鈕」交給外層的 alert / confirm / tips,兩件事彻底分開。之後要換外觀只改 html 樣板,要改動畫只改 Panel,不會互相牽扯。
幾個實作提醒:clone(true) 的 true 表示連事件一起複製,若不需要請省下;height / width 必須在 clone 之前讀取,因為 display:none 的元素雖然能取到尺寸,但一旦掛到不同上下文就可能改變;此外 Q.showPanel 目前沒有把使用者傳入的 options 展開,若要自訂寬高需自行補上。