內容簡介
Hwinote Image Scroll 擴展了 WordPress 原生的圖片區塊，提供選擇性的垂直圖片檢視器，適用於長截圖、插圖說明及其他高圖片，避免佔用過多文章空間。
【主要功能】
• 與現有的核心圖片區塊兼容
• 自動偵測高圖片選項
• 可選擇的最大檢視高度設定
• 滾動提示僅在內容溢出時顯示
• 可選的圖片擴展/收合控制
外掛標籤
開發者團隊
原文外掛簡介
Hwinote Image Scroll extends the native WordPress Image block with an opt-in vertical image viewer. It is intended for long screenshots, illustrated instructions, and other tall images that would otherwise occupy a large portion of a post.
Features:
* Works with the existing core/image block; there is no custom image block.
* Scrolling is disabled by default, leaving existing images untouched.
* Choose viewport height by aspect ratio or by pixels.
* Optional automatic tall-image detection per Image block (1.5x, 2x, or 3x height-to-width; default 2x).
* Optional separate maximum viewport height on screens 767px wide or narrower, with an 80% screen-height cap.
* Scroll hint appears only if content actually overflows (when JavaScript is available).
* Optional progress indicator shows how far the image has been scrolled.
* Optional full-image control: expand/collapse the existing image directly inside the post (default), or open the original media in a new tab.
* Expanded images have collapse controls above and below; collapsing corrects page scroll position.
* Keeps the standard Image block caption outside the scroll area on the front end.
* Preserves standard image links and native WordPress image lightbox markup.
* Lightweight, scoped CSS and dependency-free frontend JavaScript enqueued only when a scroll-enabled image is rendered.
* English source strings, Japanese translations (PO/MO and editor JSON), and a POT template.
Automatic detection applies only to image blocks where scrolling is enabled and automatic detection has been selected; it does not scan or change other image blocks. Detection uses intrinsic dimensions available in markup / WordPress metadata and rechecks loaded image dimensions in the browser. If dimensions are unavailable with JavaScript disabled, the image stays fully visible.
The editor offers an approximate visual preview. On the published page, scrolling and overflow detection are calculated against the actual rendered image. The WordPress image lightbox remains available when already enabled in the standard Image block; the full-image control can expand and collapse the existing image inside the article without navigation, or use a separate original-image link in a new tab. Neither option replaces the standard lightbox.
Related Links
Japanese Introduction and Usage Guide
