DIV CSS 佈局教程網

JS 教程:Lightbox 源碼深度解析
編輯:關於JavaScript     

Lightbox 是一款廣為流行的圖片燈箱效果腳本,點擊縮圖後能以優雅的彈出層展示大圖,並自動置中、遮罩背景。本文將逐段拆解 Lightbox 的核心源碼,帶你理解它如何在不同瀏覽器中準確獲取頁面尺寸與滾動偏移量,並完成圖片的居中顯示。

一、getPageScroll:取得視窗的滾動偏移量

function getPageScroll(){
  var yScroll;
  if (self.pageYOffset) {
    yScroll = self.pageYOffset; // Netscape 等
  } else if (document.documentElement && document.documentElement.scrollTop){
    yScroll = document.documentElement.scrollTop; // IE6 標準模式
  } else if (document.body) {
    yScroll = document.body.scrollTop; // 其他 IE
  }
  arrayPageScroll = new Array('', yScroll)
  return arrayPageScroll;
}

關於 self:打開任何一個網頁,瀏覽器都會先建立一個 window 物件,它是 JS 運行所依附的全域環境與作用域物件。self 指向視窗本身,返回的物件與 window 完全一致,因此 window 的常用方法都可以用 self 代替。

三種取得滾動條位置的方法:

  1. window.pageXOffset/pageYOffset——大多數瀏覽器支援,非常可靠。
  2. document.documentElement.scrollLeft/Top——標準模式下的 IE6 及少數瀏覽器。
  3. document.body.scrollLeft/Top——IE6 及其他一些瀏覽器。

值得注意的是,在 Safari 與 OmniWeb 4.5+ 中,當滾動條偏移量為 0 時會返回 -8,其他情況則正常。不過由於它們提供了正確的 window.pageXOffset/pageYOffset,這個 bug 並不會造成實質影響。

二、getPageSize:取得頁面與視窗的大小

function getPageSize(){
  // 整個頁面的大小
  var xScroll, yScroll;
  if (window.innerHeight && window.scrollMaxY) {
    xScroll = document.body.scrollWidth;
    yScroll = window.innerHeight + window.scrollMaxY;
  } else if (document.body.scrollHeight > document.body.offsetHeight){
    xScroll = document.body.scrollWidth;
    yScroll = document.body.scrollHeight;
  } else {
    xScroll = document.body.offsetWidth;
    yScroll = document.body.offsetHeight;
  }

  // 可見視窗(viewport)的大小
  var windowWidth, windowHeight;
  if (self.innerHeight) {
    windowWidth = self.innerWidth;
    windowHeight = self.innerHeight;
  } else if (document.documentElement && document.documentElement.clientHeight) {
    windowWidth = document.documentElement.clientWidth;
    windowHeight = document.documentElement.clientHeight;
  } else if (document.body) {
    windowWidth = document.body.clientWidth;
    windowHeight = document.body.clientHeight;
  }

  // 對於整體高度小於視窗高度的小頁面
  if(yScroll < windowHeight){
    pageHeight = windowHeight;
  } else {
    pageHeight = yScroll;
  }

  // 對於整體寬度小於視窗寬度的小頁面
  if(xScroll < windowWidth){
    pageWidth = windowWidth;
  } else {
    pageWidth = xScroll;
  }

  arrayPageSize = new Array(pageWidth, pageHeight, windowWidth, windowHeight)
  return arrayPageSize;
}

在文檔加載完成之前是無法取得視窗大小的,而且還得針對不同瀏覽器採用不同方法。可用參數包括:window.innerHeight/Width(除 IE 外的大多數瀏覽器)、document.body.clientHeight/Width 以及 document.documentElement.clientHeight/Width。

關於 clientHeight/Width 會有點混亂,因為在不同瀏覽器、甚至同一瀏覽器的不同模式(標準模式 strict 或怪異模式 quirks)下,它們的含義都可能不同——有時指視窗尺寸,有時指文檔內容尺寸。所幸還是有個相對確定的值:innerHeight,只是 IE 並不支援它。

取得視窗尺寸的算法邏輯:

  1. 若存在 window.innerHeight/Width 屬性,可完全信賴,直接使用。
  2. 否則若存在 document.documentElement.clientHeight/Width 且值大於 0,則使用它。
  3. 否則使用 document.body.clientHeight/Width。

需要注意的是,此算法在 IE6+ 的「標準相容模式」下,當視窗為 0px × 0px 大小時會失效。

三、showLightbox:核心顯示邏輯

function showLightbox(objLink)
{
  // 準備各元素物件
  var objOverlay = document.getElementById('overlay');        // 遮罩層
  var objLightbox = document.getElementById('lightbox');
  var objCaption = document.getElementById('lightboxCaption');
  var objImage = document.getElementById('lightboxImage');
  var objLoadingImage = document.getElementById('loadingImage'); // 加載圖
  var objLightboxDetails = document.getElementById('lightboxDetails');

  var arrayPageSize = getPageSize();
  var arrayPageScroll = getPageScroll();

  // 若存在加載圖,將其置中
  if (objLoadingImage) {
    objLoadingImage.style.top = (arrayPageScroll[1] + ((arrayPageSize[3] - 35 - objLoadingImage.height) / 2) + 'px');
    // top = 滾動條位置 + [視窗高度 - 35px(瀏覽器狀態欄高度) - 加載圖高度] / 2
    objLoadingImage.style.left = (((arrayPageSize[0] - 20 - objLoadingImage.width) / 2) + 'px');
    objLoadingImage.style.display = 'block';
    // 狀態欄高度約 35px,滾動條寬度約 20px
  }

  // 設置遮罩層高度以覆蓋整個頁面並顯示
  objOverlay.style.height = (arrayPageSize[1] + 'px');
  objOverlay.style.display = 'block';

  // 預加載圖片
  imgPreload = new Image();

  imgPreload.onload=function(){
    objImage.src = objLink.href;

    // 將 lightbox 置中,並確保 top/left 不為負值
    var lightboxTop = arrayPageScroll[1] + ((arrayPageSize[3] - 35 - imgPreload.height) / 2);
    var lightboxLeft = ((arrayPageSize[0] - 20 - imgPreload.width) / 2);

    objLightbox.style.top = (lightboxTop < 0) ? "0px" : lightboxTop + "px";
    objLightbox.style.left = (lightboxLeft < 0) ? "0px" : lightboxLeft + "px";

    objLightboxDetails.style.width = imgPreload.width + 'px';

    if(objLink.getAttribute('title')){
      objCaption.style.display = 'block';
      objCaption.innerHTML = objLink.getAttribute('title');
    } else {
      objCaption.style.display = 'none';
    }

    // IE 中圖片加載與顯示之間需要短暫停頓,避免閃爍
    if (navigator.appVersion.indexOf("MSIE")!=-1){
      pause(250);
    }

    if (objLoadingImage) { objLoadingImage.style.display = 'none'; } // 隱藏加載圖

    // 隱藏 select 框,避免它們在 IE 中「穿透」圖片
    selects = document.getElementsByTagName("select");
    for (i = 0; i != selects.length; i++) {
      selects[i].style.visibility = "hidden";
    }

    objLightbox.style.display = 'block';

    // 圖片加載後,因新圖可能增加頁面高度,重新更新遮罩層高度
    arrayPageSize = getPageSize();
    objOverlay.style.height = (arrayPageSize[1] + 'px');

    listenKey(); // 監聽 'x' 鍵關閉

    return false;
  }

  imgPreload.src = objLink.href;
}

透過以上幾個函數的協同運作,Lightbox 便能實現流暢的圖片燈箱效果。整個源碼的精妙之處在於:它用一層層的瀏覽器判斷,抹平了各瀏覽器在尺寸計算上的差異,同時透過預加載圖片、隱藏 select 元素、針對 IE 加入短暫停頓等細節處理,確保了跨瀏覽器的一致體驗。理解這些細節,對我們編寫健壯的前端交互代碼頗有裨益。

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