內容簡介
### 總結：
Spinnaker 是一款輕量、現代且高度無障礙的 WordPress 外掛，將任何圖像或 PDF 鏈接轉換為功能豐富的對話式燈箱。這個外掛以無障礙性為重點，確保使用鍵盤和螢幕助讀器的用戶獲得無縫體驗。
### 問題與答案：
- 問題：什麼是 Spinnaker 外掛？
- 答案：Spinnaker 是一個能將圖像和 PDF 檔案整齊儲存並在需要時展示為美觀、易於存取的燈箱的 WordPress 外掛。
- 問題：Image Lightbox 功能有哪些？
- 答案：
1. 將任何 <img> 標籤轉換為可點擊的燈箱觸發器。
2. 顯示填充視口但不強制使用雙滾動條的大型可滾動圖像版本。
3. 添加卷軸箭頭按鈕，方便導覽超大圖像。
4. 支持自定義的初始圖像定位（例如，居中、頂部、底部、左側、右側）。
5. 以「廣告板」形式顯示圖像標記，支持鏈接。
6. 提供全尺寸圖像的「下載」按鈕。
7. 完全本地化支持西班牙語、俄語、越南語、簡體中文、阿拉伯語、韓語和索馬里語 UI 文本。
- 問題：PDF Lightbox 功能有哪些？
- 答案：
1. 將任何指向 PDF 的 <a> 標籤轉換為燈箱觸發器。
2. 在您的網站上以嵌入式查看器顯示 PDF。
3. 包含「下載」按鈕。
4. 支持只能向容器添加類的頁面構建程式（如 DIVI）。
5. 追蹤 PDF 觀看和下載，統計數據可在 WordPress 管理員中查看。
6. 完全本地化支持西班牙語、俄語、越南語、簡體中文、阿拉伯語、韓語和索馬里語 UI 文本。
- 問題：如何在 Image Lightbox 中使用外掛？
- 答案：將 class image-lightbox-trigger 添加到 <img> 標籤本身。
- 問題：對於 Gutenberg 塊編輯器，應如何使用 Image Lightbox 功能？
- 答案：Gutenberg 將圖像包裹在 <figure> 元素中，將 class image-lightbox-trigger-container 添加到 figure 元素。
外掛標籤
開發者團隊
原文外掛簡介
A spinnaker is a special type of sail that is flown in front of the main sails. It’s packed away when not in use, but when the wind is right, it can be unfurled to provide a powerful boost. This plugin is named Spinnaker because it allows you to keep your images and PDFs neatly tucked away, ready to be “unfurled” into a beautiful, accessible lightbox when your users need them.
Spinnaker is a lightweight, modern, and highly accessible plugin that turns any image or PDF link into a fully-featured dialog lightbox. It’s built with accessibility as a priority, ensuring a seamless experience for users with keyboards and screen readers.
Image Lightbox Features:
Converts any tag into a clickable lightbox trigger.
Displays a large, scrollable version of your image that fills the viewport without forcing double-scrollbars.
Adds scroll-arrow buttons for easy navigation of oversized images.
Supports custom initial image positioning (e.g., center, top, bottom, left, right).
Displays image credits as a “placard,” with support for links.
Provides a “Download” button for the full-size image.
Fully localizable UI text in Spanish, Russian, Vietnamese, Simplified Chinese, Arabic, Korean, and Somali.
PDF Lightbox Features:
Usage
Image Lightbox
To make an image open in a lightbox, add the class image-lightbox-trigger to the tag itself.
For Gutenberg Block Editor:
Gutenberg wraps images in a
For Page Builders (like DIVI):
If you can only add a class to the container/module holding the image, add the class image-lightbox-trigger-container to the container. The plugin will find the first image inside it and turn it into a lightbox.
Optional Attributes (add to the
data-description="…": A longer description for screen readers. Note: Users of Gutenberg and other page builders that don’t allow custom attributes to be added can use the image’s “Title” field. The plugin will automatically use the title text for the screen reader description and remove the title attribute from the image to prevent duplicate announcements.
data-credit="…": The text for the credit placard. Requires HTML editing mode in Gutenberg.
data-credit-link="…": A URL to make the entire credit placard a link. Requires HTML editing mode in Gutenberg.
data-position="…": Set the initial scroll position. Options: top, bottom, left, right, or center (default). Requires HTML editing mode in Gutenberg.
Localization:
To translate the UI text, add a language-specific class like -es (for Spanish) to the trigger class (e.g., image-lightbox-trigger-es).
Supported languages: Spanish (-es), Russian (-ru), Vietnamese (-vi), Simplified Chinese (-zh), Arabic (-ar), Korean (-ko), and Somali (-so).
Example HTML:
PDF Lightbox
To make a link to a PDF open in a lightbox, add the class pdf-lightbox-trigger to the tag itself.
For Page Builders (like DIVI):
If you can only add a class to the container/module holding the link, add the class pdf-lightbox-trigger-container to the container. The plugin will find the correct PDF link inside it.
Localization:
To translate the UI text, add a language-specific class like -es (for Spanish) to the trigger class (e.g., pdf-lightbox-trigger-es).
Supported languages: Spanish (-es), Russian (-ru), Vietnamese (-vi), Simplified Chinese (-zh), Arabic (-ar), Korean (-ko), and Somali (-so).
Example HTML:
Directorio
