在頁面 head 中依序引入 jQuery 與外掛本體:
<script type="text/javascript" src="js/jquery-1.2.6.pack.js"></script> <script type="text/javascript" src="js/jquery.lightbox.packed.js"></script>
前者是 jQuery 函式庫,後者是 lightbox 外掛。路徑依你自己的專案結構調整。
可以到 https://plugins.jquery.com/project/issues/jquerylightbox_bal 查看看是否有人提過同樣的狀況。
| 參數名 | 說明 | 可用值 |
|---|---|---|
| show_helper_text | 是否顯示「點擊關閉」之類的提示文字 | true(預設)、false |
| show_info | 是否顯示圖片資訊 | "auto"(預設,滑鼠移過才顯示)、true(強制顯示) |
| show_extended_info | 是否顯示圖片的延伸資訊 | "auto"(預設)、true |
| download_link | 是否顯示圖片下載連結 | true(預設)、false |
| auto_resize | 圖片過大時是否自動限制尺寸 | true(預設)、false |
| colorBlend | 是否啟用顏色混合 | null(預設,偵測到才用)、true、false |
| ie6_support | 是否支援 IE6 | true(預設)、false |
| ie6_upgrade | 是否對 IE6 使用者顯示升級提示 | true(預設)、false |
| show_linkback | 是否顯示右上角的方向連結 | true(預設)、false |
| auto_scroll | 捲動處理方式 | "follow"(預設,隨使用者)、"disabled"(禁止捲動)、"ignore"(忽略捲動,lightbox 停在初始位置) |
| speed | 每次圖片轉換的過渡時間(毫秒) | 400(預設)、整數 |
| baseurl | 自動引入所需檔案的基準路徑 | null(預設,自動偵測)、字串 |
| files | 內部連結的檔案清單,檔案改名時要同步修改 | 子項:js.lightbox、js.colorBlend、css.lightbox、images.prev、images.next、images.blank、images.loading |
| text | 內部的文字字串,翻譯時修改這裡 | 子項:image、of、close、closeInfo、download、help.close、help.interact、about.text、about.title、about.link |
| keys | 快捷鍵定義,想改鍵位時修改 | 子項:close、prev、next |
| opacity | 覆蓋背景層的透明度 | 0.9(預設,90%)、數值 |
| padding | 圖片環繞的留白 | null(預設,自動偵測)、整數 |
| rel | 要搜尋的 rel 值,用以套用 lightbox 效果 | "lightbox"(預設)、字串 |
| auto_relify | 是否對 rel 做初始掃描以自動偵測 lightbox 群組 | true(預設)、false |
有兩種方式:一是直接寫在 script 的 query string 上,二是用程式碼建構時傳入。
以下範例把反向連結隱藏,同時把「圖片」改成「照片」:
<script type="text/javascript" src="js/jquery.lightbox.min.js?show_linkback=false&text.image=Photo"></script>
<script type="text/javascript" src="jquery_lightbox/js/jquery.lightbox.packed.js"></script>
<script type="text/javascript">
$(function(){
$.Lightbox.construct({
show_linkback: false,
text: {
image: '照片'
}
});
});
</script>
兩種方式效果相同,但 construct 的寫法比較適合在頁面載入後動態套用,也比較容易和其他初始化程式碼放在一起管理。
線上展示與打包下載可參考 jb51 的範例頁面。