Thickbox 是早期最流行的燈箱(Lightbox)類插件之一,除了看圖,還能彈出內嵌內容與 iframe 視窗,而且全程靠 URL 參數驅動,幾乎不必寫 JavaScript。
官方宣稱支援 Windows 上的 IE 6.0、IE 7+、Firefox 2.0.0.6+、Opera 9.0+,以及 Mac 上的 Safari 2.0.4+、Firefox 2.0.0.6+、Opera 9.10。不過就實際使用經驗來看,IE6 在 z-index 與定位上仍有零星問題,正式上線前務必實測。
<script type="text/javascript" src="path-to-file/jquery.js"></script>
<script type="text/javascript" src="path-to-file/thickbox.js"></script>
<link rel="stylesheet" href="path-to-file/thickbox.css" type="text/css" media="screen" />
把 path-to-file 換成你的實際路徑即可。CSS 少了的話彈出層會完全走位,別漏掉。
<a href="images/single.jpg" title="add a caption to title attribute / or leave blank" class="thickbox">
<img src="images/single_t.jpg" alt="Single Image"/>
</a>
關鍵只有 class="thickbox"。連結指向大圖,img 放縮圖,title 屬性會成為燈箱下方的說明文字。
只要讓這幾個連結共用同一組 rel,Thickbox 就會自動加上上一張/下一張的導覽:
<a href="images/plant1.jpg" title="Plant 1" class="thickbox" rel="gallery-plants">
<img src="images/plant1_t.jpg" alt="Plant 1" />
</a>
<a href="images/plant2.jpg" title="Plant 2" class="thickbox" rel="gallery-plants">
<img src="images/plant2_t.jpg" alt="Plant 2" />
</a>
<a href="images/plant3.jpg" title="Plant 3" class="thickbox" rel="gallery-plants">
<img src="images/plant3_t.jpg" alt="Plant 3" />
</a>
<a href="images/plant4.jpg" title="Plant 4" class="thickbox" rel="gallery-plants">
<img src="images/plant4_t.jpg" alt="Plant 4" />
</a>
rel 的值自訂,只要同組一致即可;不同相簿用不同的 rel 就能分開瀏覽。
<input alt="#TB_inline?height=300&width=400&inlineId=myOnPageContent"
title="add a caption to title attribute / or leave blank"
class="thickbox" type="button" value="Show" />
這裡的核心是 #TB_inline? 這個特殊前綴。後面接的三個參數分別是高度、寬度,以及要顯示的頁面元素 ID(inlineId)。被指名的元素在彈出時會被搬進燈箱內,關閉後再歸位。
<a href="ajax.PHP?keepThis=true&TB_iframe=true&height=250&width=400"
title="add a caption to title attribute / or leave blank"
class="thickbox">Example</a>
加上 TB_iframe=true 並給定高寬,Thickbox 就會用 iframe 把目標網頁包進來。keepThis=true 是官方範例慣用的參數,主要用來避免伺服器端快取或幫忙標識請求來源,實務上可依需要增減。
所有觸發元素都必須帶上 class="thickbox",這是插件辨識的依據;其餘行為完全靠 href 與 alt 上的查詢參數控制。更多效果與參數細節可參考官方展示頁 https://jquery.com/demo/thickbox/。