萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

Lightbox2 圖片燈箱效果實作指南:從引入到客製化

Lightbox2 簡介

Lightbox2 是經典的圖片燈箱 (Lightbox) 函式庫,支援單張/群組圖片、鍵盤導航、觸控滑動、響應式縮放、標題顯示。無相依 (原版需 jQuery,現有純 JS 版 lightbox2 v2.11+),體積小、零配置即可使用。

快速開始 (v2.11+ 純 JS 版)

1. 安裝/引入

<!-- npm: npm install lightbox2 -->
<link rel="stylesheet" href="dist/css/lightbox.min.css">
<script src="dist/js/lightbox.min.js"></script>

<!-- 或 CDN -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/lightbox2@2.11.4/dist/css/lightbox.min.css">
<script src="https://cdn.jsdelivr.net/npm/lightbox2@2.11.4/dist/js/lightbox.min.js"></script>

2. HTML 標記

<!-- 單張圖片 -->
<a href="images/photo-large.jpg"
   data-lightbox="gallery"
   data-title="日落肯丁 © 2024">
  <img src="images/photo-thumb.jpg" alt="日落肯丁縮圖">
</a>

<!-- 群組圖片 (同 data-lightbox 值) -->
<a href="images/img1-large.jpg" data-lightbox="trip" data-title="Day 1"><img src="images/img1-thumb.jpg" alt=""></a>
<a href="images/img2-large.jpg" data-lightbox="trip" data-title="Day 2"><img src="images/img2-thumb.jpg" alt=""></a>
<a href="images/img3-large.jpg" data-lightbox="trip" data-title="Day 3"><img src="images/img3-thumb.jpg" alt=""></a>

關鍵屬性說明

  • href:大圖/原圖 URL (必填)。
  • data-lightbox:群組識別碼,相同值的連結自動形成群組,支援左右鍵/滑動切換。
  • data-title:燈箱下方顯示的標題 (可含 HTML)。
  • data-alt:(v2.11+) 替代文字,用於無障礙。

常見問題排查

  1. 關閉/導航按鈕不顯示:
    • 檢查 lightbox.min.css 是否正確載入 (Network 面板 200 OK)。
    • 確認圖片路徑正確:CSS 內參考的 close.png、loading.gif、prev.png、next.png 路徑相對 CSS 檔案位置,或在 CSS 中改為絕對/CDN 路徑。
    • 若使用打包工具,需配置 file-loader/url-loader 或 asset/resource 處理圖片資源。
  2. 圖片無法載入:檢查 href 路徑、CORS 政策、伺服器 404/403。
  3. Z-index 被遮擋:Lightbox 預設 z-index: 9999,若頁面有更高層級元素,調整 CSS 變數 --lightbox-zindex (v2.11+)。

客製化配置 (v2.11+)

<script>
lightbox.option({
  'resizeDuration': 300,        // 縮放動畫時長
  'wrapAround': true,           // 群組循環播放
  'albumLabel': '圖片 %1 / %2',  // 群組計數標籤 (支援 %1 當前, %2 總數)
  'fadeDuration': 300,          // 淡入淡出時長
  'imageFadeDuration': 300,     // 圖片淡入時長
  'disableScrolling': true,     // 開啟時禁用頁面滾動
  'positionFromTop': 50,        // 距離視窗頂部距離
  'showImageNumberLabel': true  // 顯示圖片編號
});
</script>

進階應用:動態新增圖片

// AJAX 載入後動態插入
fetch('/api/gallery').then(r => r.json()).then(data => {
  const container = document.getElementById('gallery');
  data.forEach(item => {
    const a = document.createElement('a');
    a.href = item.largeUrl;
    a.dataset.lightbox = 'dynamic-gallery';
    a.dataset.title = item.caption;
    a.innerHTML = ``;
    container.appendChild(a);
  });
  // Lightbox 會自動掃描新增的元素 (v2.11+)
});

Lightbox2 以極低接入成本提供專業級燈箱體驗,是內容型網站、作品集、電商圖片展示的首選工具。

copyright © 萬盛學電腦網 all rights reserved