Carousel

Presents a sequence of content in a scrollable viewport.

Installation

Install Carousel from Oros with shadcn CLI 4.13.0.

pnpm dlx shadcn@4.13.0 add @oros/carousel

Usage

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

Open the Source tab in the preview for a complete working example.

Anatomy

Export	Responsibility
CarouselApi	The root component that owns the primary structure and state.
Carousel	A composable part of the component anatomy.
CarouselContent	Contains the primary visible content.
CarouselItem	Represents one option or repeated child.
CarouselPrevious	A composable part of the component anatomy.
CarouselNext	A composable part of the component anatomy.
useCarousel	Reads or controls the component's shared state.

API Reference

Carousel exports 7 named entries. Component exports accept the props of their underlying HTML element or Base UI component, plus an optional className, unless the source defines a more focused type.

CarouselApi Component
Carousel Component
CarouselContent Component
CarouselItem Component
CarouselPrevious Component
CarouselNext Component
useCarousel Hook

Accessibility

Preserve the native and Base UI keyboard model when composing Carousel; do not replace semantic links or controls with click-only elements.
Use concise accessible names, expose the current item when applicable, and verify focus order at both mobile and desktop widths.

Source

Carousel uses the standard shadcn API and is distributed through Oros. Installing it adds the component source and required dependencies to your app. The Source tab above shows a complete usage example.

Card Chart