React Carousel Component API

Carousel API

Explore the API reference for the React Carousel component and discover how to effectively utilize its props for customization.

On this page

jsx

import { CCarousel } from '@coreui/react'

Property	Default	Type
activeIndex	-	`number`
index of the active item.
className	-	`string`
A string of all className you want applied to the base component.
controls	-	`boolean`
Adding in the previous and next controls.
dark	-	`boolean`
Add darker controls, indicators, and captions.
indicators	-	`boolean`
Adding indicators at the bottom of the carousel for each item.
interval	`5000`	`number`, `boolean`
The amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle.
onSlid	-	`((active: number, direction: string) => void)`
Callback fired when a slide transition end.
onSlide	-	`((active: number, direction: string) => void)`
Callback fired when a slide transition starts.
pause	`hover`	`boolean`, `'hover'`
If set to 'hover', pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave. If set to false, hovering over the carousel won't pause it.
touch4.5.0+	`true`	`boolean`
Set whether the carousel should support left/right swipe interactions on touchscreen devices.
transition	-	`'slide'`, `'crossfade'`
Set type of the transition.
wrap	`true`	`boolean`
Set whether the carousel should cycle continuously or have hard stops.

jsx

import { CCarouselCaption } from '@coreui/react'

Property	Default	Type
className	-	`string`
A string of all className you want applied to the base component.

jsx

import { CCarouselItem } from '@coreui/react'

Property	Default	Type
className	-	`string`
A string of all className you want applied to the base component.
interval	-	`number`, `boolean`
The amount of time to delay between automatically cycling an item.