Carousel

A carousel component with card stack visualization for cycling through content.

Installation

npx shadcn@latest add https://scrollx-ui.vercel.app/registry/carousel.json

Usage

import { Carousel, CarouselContent, CarouselItem, } from "@/components/ui/carousel"

<Carousel className="w-full max-w-xs">
      <CarouselContent>
        {Array.from({ length: 5 }).map((_, index) => (
          <CarouselItem key={index}>
            <div className="p-1">
              <Card>
                <CardContent className="flex aspect-square items-center justify-center p-6">
                  <span className="text-4xl font-semibold">{index + 1}</span>
                </CardContent>
              </Card>
            </div>
          </CarouselItem>
        ))}
      </CarouselContent>
    </Carousel>

Examples

Carousel with Image

API Reference

Carousel

The Carousel component is the main container for the card stack carousel.

Props

Property	Type	Default	Description
`className`	string	`—`	CSS classes for the outer container. Used in: Carousel.
`children`	ReactNode	`required`	Inner content. Used in: Carousel, CarouselContent, CarouselItem.
`onClick`	() => void	`—`	Overrides default navigation. Used in: CarouselPrevious, CarouselNext.
`disabled`	boolean	`false`	Disables button. Used in: CarouselPrevious, CarouselNext.