ThickBox 是一款以 jQuery 撰寫的網頁 UI 對話視窗元件。它能承載的內容相當多元:單張圖片、成組圖片、頁面內嵌內容、iFrame 內容,或以 AJAX 混合式 modal 呈現的動態內容。對需要「點一下就把內容浮在頁面上」的場景來說,是很省事的選擇。
ThickBox 依賴 jQuery,因此必須在網頁 head 中依序載入,且 jQuery 一定要排在第一個:
<script type="text/javascript" src="path-to-file/jquery.js"></script> <script type="text/javascript" src="path-to-file/thickbox.js"></script>
引入之後,打開 thickbox.js 搜尋載入動畫圖檔的名稱(loadingAnimation.gif),依它在你伺服器上的實際位置修正路徑——這一步最常被遺漏,結果就是載入中提示圖一片空白。
<link rel="stylesheet" href="path-to-file/thickbox.css" type="text/css" media="screen" />
或者用 CSS 匯入:
<style type="text/css" media="all">@import "path-to-file/thickbox.css";</style>
若不想多發一個請求,也可以直接打開 thickbox.css,把樣式複製貼進你既有的樣式表。
完成前兩步後,只要在連結上加 class="thickbox" 並讓 href 指向要顯示的圖片或頁面即可;若要一次展示多張圖並形成上下篇的瀏覽效果,再補上 rel 分組屬性。
ThickBox 的優勢在輕量與簡單,代價是它就是「一個下載來就能用的腳本」,客製空間有限。若你的專案需要大量自訂外觀、無障礙支援(鍵盤操作、ARIA 屬性)或行動裝置體驗,建議改用維護中的替代方案;若只是要快速替既有頁面加上燈箱效果,它依然夠用。