Build Components

Image gallery

Figures in a list, with empty and described alt treated as the different things they are, and space reserved before loading.

Pattern
Figure list + reserved ratio
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

Image gallery · React + TailwindFull width

Keyboard map
KeysWhat happens
TabNothing to stop on. A gallery of pictures is not a set of controls; put the lightbox part around it if they should open.

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/image-gallery.json"

Run it in your project root. It writes components/image-gallery.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 { ImageGallery } from "@/components/image-gallery";

<ImageGallery 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.3.0. A copy you took names its version on its first line.

  1. 1.3.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.2.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.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.

  4. 1.0.03 October 2026

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

Follow changes to Image gallery (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.

  • Chromium64 passed
  • WebKit (Safari's engine)64 passed
  • iPhone, emulated64 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 Image gallery