ThickBox 是 jQuery 生態裡相當早期的彈出層外掛,能做出對話框與網頁框效果,在保持頁面不被跳離的前提下完成提示或表單輸入,使用者體驗比直接跳頁順暢許多。以下把常用的幾種用法整理出來,作為個人筆記也供需要的人參考。
需要三個檔案:thickbox.js、thickbox.css 與 jquery.js,皆可從網路取得。引入順序要把 jQuery 放在最前面:
代碼如下:
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="thickbox.js"></script>
<link rel="stylesheet" href="thickbox.css" type="text/css" />
替 <a> 或 button 加上 class="thickbox" 就能觸發。若元素是動態產生的,則改用 tb_init() 主動綁定;若要直接用程式開窗,用 tb_show()。
把縮圖包在連結裡,href 指向大圖即可,一行就搞定:
<a href="001.jpg" class="thickbox"><img src="001.jpg"/></a>
透過 #TB_inline 參數,可以把頁面上任何 display:none 的元素在彈出層中顯示,modal 則決定是否為強制模式(強制模式下背景不可點擊關閉)。
代碼如下:
<input alt="#TB_inline?height=300&width=400&inlineId=div1" title="shawnliu" class="thickbox" type="button" value="Show" />
<a href="#TB_inline?height=155&width=300&inlineId=div2&modal=true" class="thickbox">開啟強制模式內容</a>
<div id="div1" style="display:none"><p>這是一個非強制模式的對話框。</p></div>
<div id="div2" style="display:none">
<p>這是一個強制模式的對話框。
<input id="Login" onclick="tb_remove()" type="submit" value=" 確定 " /></p>
</div>
參數說明:#TB_inline 是固定寫法,height 與 width 是彈出層尺寸,inlineId 指你要顯示的元素 id,modal 切換強制/非強制模式,後面還能接你自訂的參數。tb_remove() 則是關閉彈出層的方法。
專案裡最實用的場景:新增與編輯都做成彈出層,就不必在列表頁與表單頁之間來回跳轉。

做法一樣,替連結加上 class 與尺寸參數即可:
<a href="add.shtml?width=300&height=250" class="thickbox">新增</a>
編輯的處理相同,只是先把既有資料帶進表單供使用者修改:

代碼如下:
<a href="edit.shtml?width=300&height=250&nid=item.nid" class="thickbox">編輯</a>
不想依賴 class 時,可以在 ready 階段用選取器主動綁定:
代碼如下:
<div id="PicList">
<a href="Pic01.jpg"><img src="Pic01s.jpg" border="0"/></a>
<a href="Pic02.jpg"><img src="Pic02s.jpg" border="0"/></a>
</div>
$(function () { tb_init("#PicList a"); });
以 AJAX 更新頁面內容後,新插入的元素不會自動綁上 ThickBox 行為,只要更新完成後再跑一次:
tb_init('.thickbox');
直接用 tb_show() 開窗,就能擺脫 class 限制、改用任何事件觸發。以下範例的縮圖路徑是把大圖檔名去掉最後 5 個字元再拼上 .jpg:
代碼如下:
<div id="PicList">
<img src="Pic01s.jpg" border="0"/>
<img src="Pic02s.jpg" border="0"/>
</div>
$(function () {
$("#PicList img").click(function () {
tb_show("", this.src.substring(0, this.src.length - 5) + '.jpg', false);
});
});
把 click 換成 mouseover、dblclick 或任何你想用的事件都可以。
官方宣稱支援 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 上仍會出現一些排版與圖層的問題,若專案需要兼顧 IE6,建議先實測再決定是否採用。