做文章類型的網站時,「點擊看大圖」幾乎是標配。LightBox2 是眾多 jQuery 插件裡表現相當不錯的一個,設定我就不重複了。這篇要分享的是兩件改造:讓彈出的圖片能用滾輪縮放,以及讓它能吃 Base64 編碼的圖片。
核心是把彈出後的容器綁上 mousewheel 事件。打開 lightbox.js,找到 Lightbox.prototype.build = function() {...} 這段——它在 lightbox 初始化時執行,正好可以在函數末尾把事件掛上去:
// 圖片滾輪縮放
this.img = this.$container.find('.lb-image');
this.label = this.$lightbox.find('.lb-dataContainer');
$([this.$overlay[0],this.$lightbox[0]]).bind("mousewheel", function(e){
var flag= e.originalEvent.wheelDelta < 0;
var imgH = self.img.height();
var imgW = self.img.width();
var nw = Math.round(20*imgW/imgH);
var ctH = self.$outerContainer.height();
var ctW = self.$outerContainer.width();
var layH = self.$overlay.height()-20;
var layW = self.$overlay.width()-20;
// 向下
if(flag && imgH>20 && imgW>20) {
self.img.css('height', imgH - 20);
self.img.css('width', imgW - nw);
self.$outerContainer.css('height', ctH - 20);
self.$outerContainer.css('width', ctW - nw);
if(ctW-nw > 240){
self.label.css('width', ctW - nw);
}
} else if(!flag && imgH<layH && imgW<layW) {
self.img.css('height', imgH + 20);
self.img.css('width', imgW + nw);
self.$outerContainer.css('height', ctH + 20);
self.$outerContainer.css('width', ctW + nw);
self.label.css('width', ctW + nw);
}
e.stopPropagation();
return false;
});
邏輯不難:給遮罩與燈箱都掛上滾輪監聽,高度每次變化 20px,寬度按原始比例(nw)同步縮放。向上滾放大,向下滾縮小。
三個容易忽略的地方:一是縮小要有下限,這裡用 imgH > 20 && imgW > 20 擋住,否則圖會縮成負數;二是放大要有上限,用 layH/layW(遮罩尺寸減 20)避免撐出視窗;三是一定要 e.stopPropagation() 並 return false,否則滾輪會把背後的頁面一起滾動,體驗很差。
先看原生 Lightbox 要求的 HTML 格式:
<a href="img/image.jpg" data-lightbox="test">Image #1</a>
點擊 Image #1,就會彈出一個燈箱顯示 img/image.jpg(實際上是動態產生一個 <img src="img/image.jpg" />)。
現在換個情況:如果圖片是以 Base64 編碼存在資料庫裡的呢?那就變成:
<a href="data:image/png;base64,iVBORw..." data-lightbox="test">Image #1</a>
問題來了:href 的長度在 IE 下是有上限的,稍大一點的圖片根本塞不進去,結果就是圖被截斷(只顯示上半部)。
還有一種更常見的情況——先顯示縮圖,點了才看大圖:
<a href="data:image/png;base64,iVBORw..." data-lightbox="test">
<img src="data:image/png;base64,iVBORw..." />
</a>
這下同一份 Base64 資料被傳了兩次,白白浪費頻寬與伺服器時間。
依我的需求改造之後,程式碼其實很少,只要動 Lightbox.prototype.start = function($link) {...} 裡的子函數 addToAlbum:
function addToAlbum($link) {
self.album.push({
// link: $link.attr('href'),
link: $link.children().attr("src"),
title: $link.attr('data-title') || $link.attr('title')
});
}
被註解掉的那行是原本的邏輯。$link 就是前面 HTML 裡的 a 標籤。改過之後,設定彈出圖片 src 時不再從 href 取字串,而是直接找 a 標籤子元素的 src 屬性——src 沒有長度限制,截斷問題自然消失,也不必再傳兩份資料。
第二節提到 Lightbox 對 HTML 結構有要求。如果既有文章裡的圖片只是 <img src="img/image.jpg"> 這種樣子,就得補一層包裝:
function initLightbox(){
var imgs = $(".lightbox-container").find('img');
$.each(imgs,function(i) {
var img = $(imgs[i]);
img.wrap("<a href='' data-lightbox='test' ></a>");
});
}
其中 .lightbox-container 是文章容器的 class。把 initLightbox 放在頁面 ready 時呼叫,它就會把容器內所有 img 都包成 lightbox 可用的結構,不必回頭改每一篇文章的內容。
三點裡面,第二、三點可依場景選用;改造的重點始終在第一點——滾輪縮放。改好的 lightbox 檔案可以參考原文附上的壓縮檔。