About this plugin
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.
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