DIV CSS 佈局教程網

jQuery Lightbox 圖片展示外掛使用說明
編輯:JQuery特效代碼     

一、基本資訊

  • 原作者:Benjamin Arthur Lupton
  • 版本:v1.3.7 最終版
  • 發布日期:2009 年 4 月 25 日
  • 專案網址:https://jquery.com/plugins/project/jquerylightbox_bal
  • 中文翻譯編輯:張鑫旭

二、安裝

在頁面 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是否支援 IE6true(預設)、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>

方式二:construct 方法

<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 的範例頁面。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved