Image Lightbox

Click-to-zoom image preview with gallery navigation, captions, keyboard support, and zoom.

This component requires softui.js for interactive behavior.

Default

Gradient image
<div class="sui-lightbox-thumb" style="width:200px;height:140px;">
  <img src="path/to/image.jpg" alt="Description">
</div>

<!-- Click the thumbnail to open the lightbox -->
<!-- Press Escape to close, click image to zoom -->

Grid

Image 1
Image 2
Image 3
Image 4
Image 5
Image 6
<!-- Wrap thumbnails in sui-lightbox-grid for gallery mode -->
<div class="sui-lightbox-grid" style="width:100%;max-width:500px;">
  <div class="sui-lightbox-thumb">
    <img src="image1.jpg" alt="Image 1">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="image2.jpg" alt="Image 2">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="image3.jpg" alt="Image 3">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="image4.jpg" alt="Image 4">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="image5.jpg" alt="Image 5">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="image6.jpg" alt="Image 6">
  </div>
  <!-- Lightbox auto-detects siblings for prev/next navigation -->
  <!-- Arrow keys: Left/Right to navigate, Escape to close -->
</div>

Filmstrip

Image 1
Image 2
Image 3
Image 4
Image 5
<!-- Horizontal scrolling filmstrip -->
<div class="sui-lightbox-filmstrip" style="max-width:500px;">
  <div class="sui-lightbox-thumb">
    <img src="image1.jpg" alt="Image 1">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="image2.jpg" alt="Image 2">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="image3.jpg" alt="Image 3">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="image4.jpg" alt="Image 4">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="image5.jpg" alt="Image 5">
  </div>
  <!-- Scrolls horizontally when thumbnails overflow -->
</div>

Vertical Gallery

Image 1
Image 2
Image 3
Image 4
Image 5
Image 6
Image 7
Main image
<!-- Amazon-style vertical gallery -->
<div class="sui-lightbox-vertical" style="max-width:440px;height:280px;">
  <div class="sui-lightbox-vertical-strip">
    <div class="sui-lightbox-thumb active">
      <img src="image1.jpg" alt="Image 1">
    </div>
    <div class="sui-lightbox-thumb">
      <img src="image2.jpg" alt="Image 2">
    </div>
    <div class="sui-lightbox-thumb">
      <img src="image3.jpg" alt="Image 3">
    </div>
    <div class="sui-lightbox-thumb">
      <img src="image4.jpg" alt="Image 4">
    </div>
    <div class="sui-lightbox-thumb">
      <img src="image5.jpg" alt="Image 5">
    </div>
    <div class="sui-lightbox-thumb">
      <img src="image6.jpg" alt="Image 6">
    </div>
    <div class="sui-lightbox-thumb">
      <img src="image7.jpg" alt="Image 7">
    </div>
  </div>
  <div class="sui-lightbox-vertical-main">
    <img src="image1.jpg" alt="Main image">
  </div>
</div>
<!-- Click side thumbnails to swap main image -->
<!-- Click main image to open lightbox with gallery nav -->

With Captions

Sunset
Forest
Ocean
<div class="sui-lightbox-grid" style="width:100%;max-width:500px;">
  <div class="sui-lightbox-thumb" data-caption="Sunset over the mountains with purple and blue hues">
    <img src="sunset.jpg" alt="Sunset">
  </div>
  <div class="sui-lightbox-thumb" data-caption="Lush forest canopy from above">
    <img src="forest.jpg" alt="Forest">
  </div>
  <div class="sui-lightbox-thumb" data-caption="Ocean waves at golden hour">
    <img src="ocean.jpg" alt="Ocean">
  </div>
</div>

Inset

Purple
Green
Red
Orange
<div class="sui-lightbox-grid sui-lightbox-inset" style="width:100%;max-width:500px;">
  <div class="sui-lightbox-thumb">
    <img src="purple.jpg" alt="Purple">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="green.jpg" alt="Green">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="red.jpg" alt="Red">
  </div>
  <div class="sui-lightbox-thumb">
    <img src="orange.jpg" alt="Orange">
  </div>
</div>

Reference

Key / Attribute / APIDescription
Enter / SpaceOpen the viewer from a focused thumbnail or the vertical gallery's main image; in the vertical strip, show that image.
← / →Previous / next image.
EscClose; focus returns to the thumbnail.
TabStays inside the open viewer (modal dialog); focus starts on Close.
data-srcFull-size image URL on a .sui-lightbox-thumb; defaults to the thumbnail's src.
data-altAlt text for the full-size image; defaults to the thumbnail's alt.
data-captionCaption shown under the image in the viewer.
.zoomedToggled on the viewer when the open image is clicked (zoom in / out).
SoftUI.init(el)Adds roles and tabindex to markup inserted after page load.

Delete this item?

This action cannot be undone. This will permanently delete the item and remove all associated data.