Carousel

A composable carousel with motion, swipe, and keyboard navigation built on Embla.

Loading...

Installation

$npx shadcn@latest add @craftdotui/craftui-carousel

Anatomy

<Carousel>
  <CarouselContent>
    <CarouselItem>Slide 1</CarouselItem>
    <CarouselItem>Slide 2</CarouselItem>
    <CarouselItem>Slide 3</CarouselItem>
  </CarouselContent>
  <CarouselPrevious />
  <CarouselNext />
  <CarouselDots />
</Carousel>
<Carousel.Root>
  <Carousel.Content>
    <Carousel.Item>Slide 1</Carousel.Item>
    <Carousel.Item>Slide 2</Carousel.Item>
    <Carousel.Item>Slide 3</Carousel.Item>
  </Carousel.Content>
  <Carousel.Previous />
  <Carousel.Next />
  <Carousel.Dots />
</Carousel.Root>

Demo

Sizes

Use basis-* utility classes on <CarouselItem /> to display multiple slides per view.

Loading...

Spacing

Customize the gap between slides by applying -ml-* on <CarouselContent /> and a matching pl-* on <CarouselItem />.

Loading...

Orientation

Set orientation="vertical" to scroll slides vertically.

Loading...

With Dots

Use <CarouselDots /> to render clickable pagination indicators for the slides.

Loading...

With Counter

Use setApi to listen to Embla events and display an active slide counter.

Loading...

Thumbnails

Synchronize a clickable thumbnail strip with the main carousel using setApi.

Loading...

Props

CarouselRoot

Prop
Type
Default

CarouselContent

Prop
Type
Default

CarouselItem

Prop
Type
Default

CarouselPrevious / CarouselNext

Prop
Type
Default

CarouselDots

Prop
Type
Default