1.0.1 • Published 7 years ago

material-auto-rotating-carousel-refurb v1.0.1

Weekly downloads
3
License
MIT
Repository
github
Last release
7 years ago

Disclaimer

This is a forked repo from original codebase. The main goal of this repo is to modify some of the features of autorotating-carousel.

Material AutoRotatingCarousel Build Status

NPM

So you wrote a great app and deployed it and everything. But how do you introduce new users to your app? Well, the Material design guidelines have a solution: Displaying the top benefits in a beautiful auto-rotating carousel!

This project implements such a carousel for material-ui. See the storybook for an interactive demo.

Demo

Installation

npm i --save material-auto-rotating-carousel-refurb
npm i --save react-motion

Usage

The usage is similar to the usage of Material UI's tabs. Create AutoRotatingCarousel as a main frame and add Slides as children.

import { AutoRotatingCarousel, Slide } from 'material-auto-rotating-carousel'
import { green400, green600, blue400, blue600, red400, red600 } from 'material-ui/styles/colors'

// ...

render() {
  return (
    <div>
      <AutoRotatingCarousel
        label="Get started"
        open
      >
        <Slide
          media={<img src="http://www.icons101.com/icon_png/size_256/id_79394/youtube.png" />}
          mediaBackgroundStyle={{ backgroundColor: red400 }}
          contentStyle={{ backgroundColor: red600 }}
          title="This is a very cool feature"
          subtitle="Just using this will blow your mind."
        />
        <Slide
          media={<img src="http://www.icons101.com/icon_png/size_256/id_80975/GoogleInbox.png" />}
          mediaBackgroundStyle={{ backgroundColor: blue400 }}
          contentStyle={{ backgroundColor: blue600 }}
          title="Ever wanted to be popular?"
          subtitle="Well just mix two colors and your are good to go!"
        />
        <Slide
          media={<img src="http://www.icons101.com/icon_png/size_256/id_76704/Google_Settings.png" />}
          mediaBackgroundStyle={{ backgroundColor: green400 }}
          contentStyle={{ backgroundColor: green600 }}
          title="May the force be with you"
          subtitle="The Force is a metaphysical and ubiquitous power in the Star Wars universe."
        />
      </AutoRotatingCarousel>
    </div>
  )
}

AutoRotatingCarousel Properties

NameTypeDefaultDescription
autoplaybooltrueIf false, the auto play behavior is disabled.
contentStyleobjectOverride the inline-styles of the content container.
intervalinteger3000Delay between auto play transitions (in ms).
label*stringButton text.
landscapeboolIf true, slide will adjust content for wide mobile screens.
mobileboolfalseIf true, the screen width and height is filled.
openboolfalseControls whether the AutoRotatingCarousel is opened or not.
onChangefunctionFired when the index changed. Returns current index.
onRequestClosefunctionnoopFired when the gray background of the popup is pressed when it is open.
onStartfunctionFired when the user clicks the getting started button.
styleobjectOverride the inline-styles of the root component.

Slide Properties

NameTypeDefaultDescription
contentStyleobjectOverride the inline-styles of the content.
media*nodeObject to display in the upper half.
mediaBackgroundStyleobjectOverride the inline-styles of the media container.
mediaStyleobjectOverride the inline-styles of the media.
subtitle*stringSubtitle for the slide.
subtitleStyleobjectOverride the inline-styles of the subtitle.
textStyleobjectOverride the inline-styles of the text container.
title*stringTitle for the slide.
titleStyleobjectOverride the inline-styles of the title.

* required property

License

The files included in this repository are licensed under the MIT license.