react-background-slider
v4.0.0
Published
Simply beautiful react background slideshow
Downloads
1,688
Readme
React Background Slider
Simply beautiful background image slider for React 🌅
Intro
This component is meant to be used as a full viewport background slideshow that can easily add a slick, polished feel to pages that don't have much content.
I've personally used it for several projects as the background for login / signup / dialog screens where the only content is a single foreground modal generally prompting the user for some info.
Install
# use npm
npm install --save react-background-slider
# use yarn
yarn add react-background-slider
Usage
import BackgroundSlider from 'react-background-slider'
<BackgroundSlider
images={[image1, image2, ...]}
duration={10} transition={2} />
API
BackgroundSlider
props.images
- string[], required array of images to transition between.props.duration
- number, duration of which each image is displayed (default10
)props.transition
- number, duration of the transition (default2
)
The component will start with the first image.
Demo
This repo comes with an example application under example/
that can be run locally to experiment with the component. This demo is also hosted here.
To launch the demo app
npm start
This will start the webpack dev server locally on port 9000.
License
MIT