DIV CSS 佈局教程網

用 jQuery 實作 overlay 遮罩層:單例模式與 ajax 全域錯誤處理
編輯:JQuery特效代碼     

遮罩層是模態對話框的基礎建設:一個鋪滿整個視窗的半透明層,攔住背後的所有互動,讓使用者的注意力集中在彈出的內容上。這裡用單例的方式把它包成一個建構函式。

一、遮罩層本體

/*
 * 模態遮罩層單例物件
 * opacity: 背景透明度
 * 1. show()
 * 2. close()
 */
Q.Overlay = function(opacity) {
  var self = this;

  self._createDiv = function() {
    if (self._overlay) return;   // 已建立則不重複
    self._overlay = $("<div></div>");

    var overlayCss = {
      'width': '100%',
      'min-height': '100%',
      'position': 'fixed',
      'top': 0,
      'left': 0,
      'z-index': Q.Overlay.zindex,
      'background': '#ccc',
      'text-align': 'center',
      'opacity': opacity
    };

    // 舊 IE 不認 fixed,改用 absolute 並手動撐滿整頁高度
    if ($.browser.msie && $.browser.version.substr(0, 1) < 7) {
      overlayCss.position = "absolute";
      overlayCss.height = Q.dom.pageHeight();
    }

    self._overlay.css(overlayCss);
    $(document.body).append(self._overlay);
  };

  self.show = function() {
    self._createDiv();
    Q.Overlay.zindex++;
    self._overlay.show();
  };

  self.close = function() {
    self._overlay.hide();
    self._overlay.remove();
    self._overlay = undefined;
  };
};

Q.Overlay.zindex = 1000;

二、幾個設計決定

z-index 用靜態屬性遞增。Q.Overlay.zindex 從 1000 起算,每次 show 就加一,這樣多層遮罩堆疊時,後開的一定在上面,不必每個呼叫端自己算數字。

close 時真的 remove。不只是 hide,而是把節點從 DOM 摘掉並把參照設回 undefined。這樣下次 show 時 _createDiv 裡的 if 判斷才會重新走一次建立流程,透明度等參數也能跟著更新。

舊 IE 的 fixed 問題。IE6 不支援 position: fixed,因此改用 absolute 並搭配手動計算的整頁高度 Q.dom.pageHeight()。這段判斷用了 $.browser,該 API 已在 jQuery 1.9 移除,新專案請改用特色偵測。

三、一個實際應用:ajax 全域錯誤處理

遮罩層最實用的場合之一,是在 ajax 請求進行中阻擋使用者操作,避免他連點兩下滑出重複請求;請求失敗時再給一個明確提示。

/* 統一 ajax 錯誤處理 */
Q.initAjaxErrorHandler = function() {
  var overlay = new Q.Overlay(0.0);   // 完全透明,只攔互動不改觀感

  $(document.body).ajaxStart(function() {
    overlay.show();
  });

  $(document.body).ajaxSuccess(function() {
    overlay.close();
  });

  $(document.body).ajaxError(function() {
    Q.alert("請求出錯,請刷新頁面並稍候再試!");
  });
};

這裡透明度刻意設為 0.0:使用者看不到任何視覺變化,但滑鼠點擊被吃掉了,正好達到「鎖住介面」的效果。若希望讓使用者明確感知到「系統忙碌中」,則可改為 0.3 左右,並在遮罩上放一張 loading 動畫。

四、一個要留意的細節

ajaxError 的回呼裡只呼叫了 Q.alert,卻沒有關閉遮罩。實作時請確認錯誤路徑也會走到 close——否則遮罩會永遠留在畫面上,使用者只能重新整理。比較穩健的寫法是在 complete 而非 success 中收遮罩,因為 complete 無論成功失敗都會觸發。

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