DIV CSS 佈局教程網

jQuery 居中彈出層實作:Panel、Overlay 與通用對話框封裝
編輯:JQuery特效代碼     

有了遮罩層之後,下一步自然是「置中的彈出視窗」。這裡示範一個 Q.Panel,負責定位、淡入淡出、視窗 resize 與捲動時的重新置中,並可選擇是否搭配遮罩形成模態效果。

一、Panel 本體

/*
 * 彈出視窗置中於瀏覽器
 * 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 移除的節點設定樣式,白白浪費效能。

三、四個基於 Panel 的通用元件

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 展開,若要自訂寬高需自行補上。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved