# Carousel API

> Auto-generated API reference for `Carousel` from @vuetify/v0 (Vuetify0).
> Source of truth: https://0.vuetifyjs.com/api/carousel

## Related

- https://0.vuetifyjs.com/components/semantic/carousel
- https://0.vuetifyjs.com/components/providers/step
- https://0.vuetifyjs.com/composables/selection/create-step
- https://0.vuetifyjs.com/components/primitives/atom

## Carousel.Root

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `id` | `string \| undefined` | — | no | Unique identifier for the carousel |
| `label` | `string \| undefined` | — | no | Accessible label for the carousel region |
| `namespace` | `string \| undefined` | `"v0:carousel"` | no | Namespace for dependency injection (must match child namespace) |
| `disabled` | `boolean \| undefined` | `false` | no | Disables the entire carousel |
| `circular` | `boolean \| undefined` | `false` | no | Whether navigation wraps around from last to first |
| `orientation` | `CarouselOrientation \| undefined` | `"horizontal"` | no | Carousel orientation |
| `perView` | `number \| undefined` | `1` | no | Number of slides visible at once |
| `autoplay` | `number \| undefined` | `0` | no | Autoplay interval in milliseconds. 0 disables autoplay. |
| `behavior` | `ScrollBehavior \| undefined` | `"smooth"` | no | Scroll behavior for programmatic navigation |
| `modelValue` | `T \| T[] \| undefined` | — | no | — |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `CarouselRootSlotProps` | — |

## Carousel.Indicator

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `label` | `string \| undefined` | — | no | Accessible label for the indicator group |
| `namespace` | `string \| undefined` | `"v0:carousel"` | no | Namespace for connecting to parent Carousel.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `CarouselIndicatorSlotProps` | — |

## Carousel.Item

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `id` | `any` | — | no | Unique identifier (auto-generated if not provided) |
| `value` | `V \| undefined` | — | no | Value associated with this slide |
| `disabled` | `MaybeRefOrGetter<boolean> \| undefined` | — | no | Disables this specific slide |
| `namespace` | `string \| undefined` | `"v0:carousel"` | no | Namespace for dependency injection |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `CarouselItemSlotProps` | — |

## Carousel.LiveRegion

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:carousel"` | no | Namespace for connecting to parent Carousel.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `CarouselLiveRegionSlotProps` | — |

## Carousel.Next

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:carousel"` | no | Namespace for connecting to parent Carousel.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `CarouselNextSlotProps` | — |

## Carousel.Previous

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:carousel"` | no | Namespace for connecting to parent Carousel.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `CarouselPreviousSlotProps` | — |

## Carousel.Progress

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:carousel"` | no | Namespace for connecting to parent Carousel.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `CarouselProgressSlotProps` | — |

## Carousel.Viewport

### Props

| Name | Type | Default | Required | Description |
|---|---|---|---|---|
| `namespace` | `string \| undefined` | `"v0:carousel"` | no | Namespace for connecting to parent Carousel.Root |

### Slots

| Name | Type | Description |
|---|---|---|
| `default` | `CarouselViewportSlotProps` | — |