JSPM

  • Created
  • Published
  • Downloads 96538
  • Score
    100M100P100Q162413F
  • License MIT

A Generic, extendible Carousel UI component for React using Material UI

Package Exports

  • react-material-ui-carousel

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (react-material-ui-carousel) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

React Material UI Carousel

Description

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.

Live Demo

Take a look at this interactible Live Demo

Installation

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

Usage Example

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>
    )
}

Next & Prev Usage

    <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.

Props

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

License

The MIT License.

Author

Learus