Build Components

Lightbox

Thumbnails that open a full-screen viewer with arrow keys, swipe, captions and focus kept inside.

Pattern
APG Dialog (Modal) gallery
Category
Content · Media
Outputs
React + Tailwind (Next.js or any React app), HTML/CSS/JS, Vue (Nuxt), Svelte (SvelteKit), Astro, Angular, Solid, Web Component
Status
In stock, tested

Test bench

Runs the exported code, not a mock-up.

Output
Screen width

Lightbox · React + TailwindFull width

Keyboard map
KeysWhat happens
EnterorSpaceOn a thumbnail: open it in the viewer. Focus moves to Close.
← →In the viewer: previous or next picture.
HomeorEndIn the viewer: first or last picture.
TabMove between Close, Previous and Next. Focus stays in the viewer.
EscapeClose the viewer and return to the thumbnail you opened.

Take it home

React + Tailwind CSS v4: install with one command, or copy the file. Your options are already in it.

npx shadcn@latest add "/r/lightbox.json"

Run it in your project root. It writes components/lightbox.tsx with the options you set here. Needs Tailwind CSS v4 and a project set up for the shadcn CLI (npx shadcn@latest init).

Use it with your own data

import { Lightbox } from "@/components/lightbox";

<Lightbox config={{ items: yourData }} />

Pass only what changes: the rest keep the options set in the file. items takes the same shape as the file's own list.

Changes

This is 1.4.0. A copy you took names its version on its first line.

  1. 1.4.013 October 2026

    Added. The React component takes config as just the options you pass, so data from your page (a list of products, the options of a select) goes straight in; the rest keep the file's defaults. Every file now carries its licence: MIT.

  2. 1.3.09 October 2026

    Added. An Astro file, and the Vue and Svelte files now tested in Nuxt and SvelteKit too: rendered on the server, then started in the browser.

  3. 1.2.05 October 2026

    Added. Every word it says by itself is an option (the Words group), so it can speak your page's language; the editor fills them in for ten languages.

  4. 1.1.14 October 2026

    Fixed. In a right-to-left page the Left and Right arrow keys swap, as the layout does.

  5. 1.1.04 October 2026

    Added. Takes the site theme when a page has one: colours, corners, body font, and the page's own light or dark choice.

  6. 1.0.03 October 2026

    Released. As it was on the site when versions began.

Follow changes to Lightbox (RSS)

Last test run

5 October 2026, at commit 0adb641: this part's own tests, in every output: React, HTML/CSS/JS and the five framework files.

  • Chromium43 passed
  • WebKit (Safari's engine)43 passed
  • iPhone, emulated43 passed

What every part is tested for

Found a problem?

Write to us: the subject already names the part and this version.

Report a problem with Lightbox