Lightbox 是一款廣為流行的圖片燈箱效果腳本,點擊縮圖後能以優雅的彈出層展示大圖,並自動置中、遮罩背景。本文將逐段拆解 Lightbox 的核心源碼,帶你理解它如何在不同瀏覽器中準確獲取頁面尺寸與滾動偏移量,並完成圖片的居中顯示。
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 代替。
三種取得滾動條位置的方法:
window.pageXOffset/pageYOffset——大多數瀏覽器支援,非常可靠。document.documentElement.scrollLeft/Top——標準模式下的 IE6 及少數瀏覽器。document.body.scrollLeft/Top——IE6 及其他一些瀏覽器。值得注意的是,在 Safari 與 OmniWeb 4.5+ 中,當滾動條偏移量為 0 時會返回 -8,其他情況則正常。不過由於它們提供了正確的 window.pageXOffset/pageYOffset,這個 bug 並不會造成實質影響。
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 並不支援它。
取得視窗尺寸的算法邏輯:
window.innerHeight/Width 屬性,可完全信賴,直接使用。document.documentElement.clientHeight/Width 且值大於 0,則使用它。document.body.clientHeight/Width。需要注意的是,此算法在 IE6+ 的「標準相容模式」下,當視窗為 0px × 0px 大小時會失效。
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 加入短暫停頓等細節處理,確保了跨瀏覽器的一致體驗。理解這些細節,對我們編寫健壯的前端交互代碼頗有裨益。