A Generic, extendible Carousel UI component for React using Material UI
It switches between given children using a smooth animation.
Provides next and previous buttons.
Also provides interactible bullet indicators.
Take a look at this interactible Live Demo
npm install react-material-ui-carousel --save
Note:
You will need to have material-ui
installed, in order to use this library/component
npm install @material-ui/core
npm install @material-ui/icons
import React from 'react';
import Carousel from 'react-material-ui-carousel'
import {Paper} from '@material-ui/core'
function Example(props)
{
var items = [
{
name: "Random Name #1",
description: "Probably the most random thing you have ever seen!"
},
{
name: "Random Name #2",
description: "Hello World!"
}
]
return (
<Carousel>
{
items.map( (item, i) => <Item key={i} item={item} /> )
}
</Carousel>
)
}
function Item(props)
{
return (
<Paper>
<h2>{props.item.name}</h2>
<p>{props.item.description}</p>
<Button className="CheckButton">
Check it out!
</Button>
</Paper>
)
}
<Carousel
next={ (next, active) => console.log(`we left ${active}, and are now at ${next}`); }
prev={ (prev, active) => console.log(`we left ${active}, and are now at ${prev}`); }
>
{...}
</Carousel>
// OR
<Carousel
next={ () => {/* Do stuff */} }
prev={ () => {/* Do other stuff */} }
>
{...}
</Carousel>
// And so on...
Note: onChange
works in a similar fashion. See Props below.
Prop name | Type | Default | Description |
---|---|---|---|
className | string |
"" | Defines custom class name(s), that will be added to Carousel element |
autoPlay | boolean |
true |
Defines if the component will auto scroll between children |
interval | number |
4000 |
Defines the interval in ms between active child changes (autoPlay) |
indicators | boolean |
true |
Defines the existence of bullet indicators |
animation | "fade" | "slide" |
"fade" |
Defines the animation style of the Carousel |
timeout | number | {appear? number, enter?: number, exit?: number} |
500 |
Defines the duration of the animation |
navButtonsAlwaysVisible | boolean |
false |
Defines if the next/previous buttons will always be visible or not |
navButtonsAlwaysInvisible | boolean |
false |
Defines if the next/previous buttons will always be invisible or not |
fullHeightHover | boolean |
true |
Defines if the the next/previous button wrappers will cover the full height of the Item element and show buttons on full height hover |
startAt | number |
0 |
Defines which child (assuming there are more than 1 children) will be displayed first. If (startAt > children.length) then if (strictIndexing) startAt = last element index |
strictIndexing | boolean |
true |
Defines whether startAt can be bigger than children length |
indicatorProps | {className: string, style: React.CSSProperties} |
undefined |
Used to customize the non-active indicators |
activeIndicatorProps | {className: string, style: React.CSSProperties} |
undefined |
Used to customize the active indicator |
onChange | (index: number, active: number) => void (internally: Function ) |
() => {} |
Function that is called after internal next(), prev(), and pressIndicator() method. First argument is the child we are going to display, while the second argument is the child that was previouslky displayed. Will only get called on next() if props.next === undefined and only get called on prev() if props.prev === undefined |
next | (next: number, active: number) => void (internally: Function ) |
() => {} |
Function that is called after internal next() method. First argument is the child we are going to display, while the second argument is the child that was previously displayed |
prev | (prev: number, active: number) => void (internally: Function ) |
() => {} |
Function that is called after internal prev() method. First argument is the child we are going to display, while the second argument is the child that was previously displayed |
The MIT License.