Lightbox2 是經典的圖片燈箱 (Lightbox) 函式庫,支援單張/群組圖片、鍵盤導航、觸控滑動、響應式縮放、標題顯示。無相依 (原版需 jQuery,現有純 JS 版 lightbox2 v2.11+),體積小、零配置即可使用。
<!-- 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>
<!-- 單張圖片 -->
<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+) 替代文字,用於無障礙。lightbox.min.css 是否正確載入 (Network 面板 200 OK)。close.png、loading.gif、prev.png、next.png 路徑相對 CSS 檔案位置,或在 CSS 中改為絕對/CDN 路徑。file-loader/url-loader 或 asset/resource 處理圖片資源。href 路徑、CORS 政策、伺服器 404/403。z-index: 9999,若頁面有更高層級元素,調整 CSS 變數 --lightbox-zindex (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 以極低接入成本提供專業級燈箱體驗,是內容型網站、作品集、電商圖片展示的首選工具。