VisorVisor
ComponentsDeck

CarouselGallery

An image grid with click-to-enlarge lightbox viewing and optional captions.

Features

  • Image grid with click-to-enlarge — thumbnails open in a full-screen viewer
  • Built on Visor Lightbox — inherits keyboard, touch, and accessibility support
  • Optional image captions — display descriptive text beneath each image

Installation

npx visor add deck-carousel-gallery

Usage

import { CarouselGallery } from '@/components/deck/carousel-gallery/carousel-gallery';

const slides = [
  { src: '/images/photo-1.jpg', alt: 'Mountain view' },
  { src: '/images/photo-2.jpg', alt: 'Ocean sunset', caption: 'Malibu, CA' },
  { src: '/images/photo-3.jpg', alt: 'City skyline' },
];

export default function Example() {
  return <CarouselGallery slides={slides} />;
}

API Reference

PropTypeDefaultDescription
slidesGallerySlide[]Array of image objects
classNamestringAdditional CSS class

GallerySlide

PropertyTypeRequiredDescription
srcstringYesImage URL
altstringYesAlt text for accessibility
captionstringNoOptional caption text