Zoomable Justified Gallery

Installation

A real shadcn registry command, not a copy-paste stand-in: it fetches this block plus its media-slot dependencies and any missing npm packages, and installs them straight into your project.

Prefer not to use the CLI? Copy the source from the Code toggle above into src/components/blocks/gallery/gallery16.tsx instead.

Usage

The file also exports gallery16Demo, the exact props behind the preview above. Spread it to get a working section in one line, then replace it with your own data.

import { Gallery16, gallery16Demo } from "@/components/blocks/gallery/gallery16";

export default function Page() {
  return <Gallery16 {...gallery16Demo} />;
}

Props

Types

interface JustifiedPhoto {
  id: string;
  caption?: string;
  /** Width divided by height, used to size the frame within its justified row. */
  aspectRatio: number;
  image?: MediaSlotImage;
}

Behavior notes

• The row layout is a flex-wrap approximation of a true justified gallery: each frame's flex-grow is sized by its own aspectRatio value rather than a full justified-layout algorithm.
• Clicking the open picture toggles real useState between a letterboxed "fit" size (object-contain, capped height) and a larger "fill" size (object-cover, bigger box); this is the block's zoom control, there's no separate zoom button.
• Prev/next cycle through the photos array and intentionally leave the fit/fill toggle as-is, so browsing several photos in "fill" mode doesn't reset on every step; opening a fresh photo from the grid or closing the viewer resets it back to "fit".