# Carousel > Content carousel using TotalSlides + CarouselItem. Subcomponents auto-installed as dependencies. Source: https://shellui.dev/docs/v0.4/components/advanced/carousel Carousel uses a `TotalSlides` + `` API. Items are passed as direct children via `` — each item must declare `TotalSlides` so it can calculate its own width. ## Installation ```bash shellui add carousel ``` `carousel-item`, `carousel-content`, `carousel-previous`, `carousel-next`, and `carousel-dots` are auto-installed as dependencies. ## Usage ### Basic (text/content) ```razor

Slide 1

Welcome to ShellUI Carousel

Slide 2

Beautiful components for Blazor

Slide 3

Built with Tailwind CSS

@code { private int _slide = 0; } ``` ### Auto-play ```razor

Slide 1

Slide 2

Slide 3

@code { private int _slide = 0; } ``` ### Image carousel with dots ```razor Landscape 1 Landscape 2 Landscape 3 @code { private int _slide = 0; } ``` ## API Reference ### `` | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `TotalSlides` | `int` | — | Total number of slides | | `CurrentSlide` | `int` | `0` | Index of the currently visible slide | | `CurrentSlideChanged` | `EventCallback` | — | Fires when the active slide changes | | `AutoPlay` | `bool` | `false` | Enables automatic slide advancement | | `AutoPlayInterval` | `int` | `3000` | Milliseconds between auto-advances | | `AspectRatio` | `string?` | `null` | CSS aspect-ratio value, e.g. `"16/9"`, `"21/9"` | | `ShowDots` | `bool` | `false` | Show dot indicators below the carousel | | `Class` | `string?` | `null` | Additional CSS classes | | `ChildContent` | `RenderFragment` | — | `CarouselItem` children | ### `` | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `TotalSlides` | `int` | — | Must match the parent `Carousel.TotalSlides` — used for width calculation | | `ChildContent` | `RenderFragment` | — | Slide content | Render previous/next arrow buttons. No parameters required.