lightbox 是經典的圖片燈箱插件,但它顯示說明文字的方式有個限制——只能用 title 屬性。而 title 是純文字,無法設定字級、顏色、換行。本文示範如何改動一個地方,讓說明支援完整 HTML。
<a href="image-url" rel="lightbox" title="image-remark"> 內容 </a>
用法很簡單:加上 rel="lightbox",點擊連結後 lightbox 會顯示該圖片,並把連結的 title 屬性當作說明文字。
問題就在這裡:若要為說明加上格式,例如調整字級、顏色,甚至插入多段落與圖示,title 屬性完全做不到。
本文以 lightbox 2.04 版為例。好消息是它的主要程式碼量不大,改動一處即可。
打開 lightbox.js,找到第 218 行附近:
this.imageArray.push([imageLink.href, imageLink.title]);
這裡直接讀取了連結的 title 屬性。把它換成讀取某個 DOM 元素的內容:
this.imageArray.push([imageLink.href, document.getElementById(imageLink.contentId).innerHTML]);
改動只有這一行。從這句程式碼可以看出,我們需要為連結加上一個自訂的 contentId 屬性,其值是某個 DOM 元素的 id,而該元素的 HTML 內容就是圖片說明。
<a href="image-url" rel="lightbox" contentId="imgDesc" title="image"> <div id="imgDesc" style="display:none">description</div> 內容 </a>
說明文字放在一個隱藏的 div 裡,用 display:none 藏起來避免影響版面;lightbox 打開時會取它的 innerHTML 作為說明。因為取的是 innerHTML 而非 textContent,所以任何 HTML 標籤都會被正確渲染。
說明元素建議放在 a 標籤外面。上面把 div 放在 a 裡面能運作,但 HTML 規範中不建議在行內元素內放區塊元素。更乾淨的寫法是把說明 div 放在連結之後,用 id 關聯即可。
contentId 不是標準屬性。在 HTML5 之前這會導致驗證失敗。若在意這點,可改用 data-content-id,再用 imageLink.getAttribute("data-content-id") 讀取。
改動核心檔案的代價。直接修改插件原始碼意味著升級時得重做一遍。若專案允許,更好的做法是在自己的初始化腳本中覆寫相關行為,或提交 patch 給上游專案。
引入 XSS 風險。用 innerHTML 注入的內容若有任何部分來自使用者輸入,就構成了注入漏洞。說明文字若由後台編輯撰寫,仍應確保內容經過淨化。
lightbox 已不再是唯一選擇。GLightbox、PhotoSwipe、Fancybox 等現代燈箱都原生支援 HTML 內容、影片、圖片組,並具備完整的鍵盤操作與無障礙支援,也不必手動改核心程式碼。若只是維護既有專案,上述改法很有效;若是新專案,直接選一個現代方案會省下更多時間。