Carousel
React carousel is a slideshow component for cycling through elements.
Usage
Example
Script
//slides=[]...
const [activeIndex, setActiveIndex] = useState(0)
return (
<div>
<CRow>
<CCol sm={12}>
<CCarousel activeIndex={activeIndex}>
<CCarouselIndicators/>
<CCarouselInner>
<CCarouselItem>
<img className="d-block w-100" src={slides[0]} alt="slide 1"/>
<CCarouselCaption><h3>Slide 1</h3><p>Slide 1</p></CCarouselCaption>
</CCarouselItem>
<CCarouselItem>
<img className="d-block w-100" src={slides[1]} alt="slide 2"/>
<CCarouselCaption><h3>Slide 2</h3><p>Slide 2</p></CCarouselCaption>
</CCarouselItem>
<CCarouselItem>
<img className="d-block w-100" src={slides[2]} alt="slide 3"/>
<CCarouselCaption><h3>Slide 3</h3><p>Slide 3</p></CCarouselCaption>
</CCarouselItem>
</CCarouselInner>
<CCarouselControl direction="prev"/>
<CCarouselControl direction="next"/>
</CCarousel>
</CCol>
</CRow>
</div>
)
# Features
- Slides to next item in intervals
- Item could be an image or other content
- Controlled by arrows and indicators
# Carousel API
| Name | Required | Type | Default Value |
|---|---|---|---|
| className | string | ||
| user classes for the main HTML tag | |||
| children | any[] | ||
| children components | |||
| innerRef | (object | Function | string) | ||
| ref to the main tag | |||
| activeIndex | number | 0 | |
| index of the active item | |||
| autoSlide | number | ||
| slide starts on beginning | |||
| animate | boolean | ||
| set animate variable for created context | |||
| onSlideChange | Function | ||
| on state change callback | |||
Context
- creates own context
CarouselCaption
# CarouselCaption API
| Name | Required | Type | Default Value |
|---|---|---|---|
| className | string | ||
| user classes for the main HTML tag | |||
| innerRef | (object | Function | string) | ||
| ref to the main tag | |||
CarouselControl
# CarouselControl API
| Name | Required | Type | Default Value |
|---|---|---|---|
| className | string | ||
| user classes for the main HTML tag | |||
| children | any | ||
| children components | |||
| innerRef | (object | Function | string) | ||
| ref to the main tag | |||
| direction | true | (prev | next) | |
| moving direction | |||
CarouselIndicators
# CarouselIndicators API
| Name | Required | Type | Default Value |
|---|---|---|---|
| className | string | ||
| user classes for the main HTML tag | |||
| innerRef | (object | Function | string) | ||
| ref to the main tag | |||
| indicatorsClass | string | carousel-indicators | |
| indicators user classes | |||
CarouselInner
# CarouselInner API
| Name | Required | Type | Default Value |
|---|---|---|---|
| className | string | ||
| user classes for the main HTML tag | |||
| innerRef | (object | Function | string) | ||
| ref to the main tag | |||
CarouselItem
# CarouselItem API
| Name | Required | Type | Default Value |
|---|---|---|---|
| children | any | ||
| children components | |||
| className | string | ||
| user classes for the main HTML tag | |||
| innerRef | (object | Function | string) | ||
| ref to the main tag | |||