Need help with react-animated-slider?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

erichbehrens
230 Stars 66 Forks MIT License 183 Commits 21 Opened issues

Description

Animated slider/carousel component for react

Services available

!
?

Need anything else?

Contributors list

# 62,708
vscode
Visual ...
HTML
CSS
113 commits
# 27,052
HTML
Express
PHP
Gulp
9 commits
# 181
nextjs
postman...
graphql...
angular...
8 commits
# 608,340
React
image-s...
reactjs...
CSS
1 commit

react-animated-slider

npm version downloads Greenkeeper badge CircleCI dependencies devDependencies minified size minified + gzipped size

A Slider/Carousel component for React supporting custom css animations.

Demo - Codesandbox Playground

Preview

Features

  • Ready to use slider component with animations
  • Easy customization
  • Horizontal or vertical navigation
  • Swipe navigation on touch devices
  • Infinite slider
  • Autoplay
  • Supports any element as children
  • Clean DOM without dirty manipulations
  • Support for CSS modules
  • Works with SSR
  • Works on IE11

Install

npm install react-animated-slider

Note: this component relies on

getDerivedStateFromProps
and requires
[email protected]
or newer. For older react versions please install
react-animated-slider
version 1:
npm install [email protected]^1

Most Simple Use

import Slider from 'react-animated-slider';
import 'react-animated-slider/build/horizontal.css';

const slides = [ { title: 'First item', description: 'Lorem ipsum'} { title: 'Second item', description: 'Lorem ipsum'} ];

{slides.map((slide, index) =>

{slide.title}

{slide.description}
)}

Properties

| property | type | default | description | |-|-|-|-| | slideIndex |

number
|
0
| Index of the slide that will be initially displayed. | | duration |
number
|
2000
(ms) | Duration of the animation in milliseconds. It is used to remove the
animateIn
and
animateOut
classNames and assign
current
after the transition has completed. | | disabled |
boolean
|
false
| Disable slider navigation | | infinite |
boolean
|
true
| Enable or disable infinite loop through slides. Sliders with only 2 children will have this option set to
false
| | autoplay |
number
|
undefined
| Autoplay interval in miliseconds. If
undefined
the slider will not play automatically. The timer will be paused and reset during user interactions such as mouse over or touch, to avoid sliding away the elements when the user wants to click them. | | touchDisabled |
boolean
|
false
| Disable slider navigation through touch events | | minSwipeOffset |
number
|
15
(px) | Minimum distance in pixels to swipe for triggering a navigation event | | previousButton |
ReactElement
| arrow svg | Will be rendered inside the previous button | | nextButton |
ReactElement
| arrow svg | Will be rendered inside the next button | | classNames |
object
| see below | Object representing the CSS classNames that will be apllied to the slides. |
{
  slider: 'slider',
  previousButton: 'previousButton',
  nextButton: 'nextButton',
  buttonDisabled: 'disabled',
  track: 'track',
  slide: 'slide',
  hidden: 'hidden',
  previous: 'previous',
  current: 'current',
  next: 'next',
  animateIn: 'animateIn',
  animateOut: 'animateOut',
}

Classnames

| class | description | |-|-| | slider | element wrapping the whole Slider | | previousButton | previous button | | nextButton | next button | | buttonDisabled | disabled state for previous and next button | | track | element wrapping all slides | | slide | apllied to every child item | | hidden | a slide that is not visible and is not adjacent to the current slide, therefore no animation will be applied | | previous | the slide that will appear or is appearing when the slider navigated back | | next | the slide that will appear or is appearing when the slider navigated forward | | animateIn | the slide moving into the view | | animateOut | the slide moving out of the view |

Events

| property | description | |-|-| | onSlideChange | called after a slide change animation has ended. Receives an object with the new slide index as argument:

 console.log(event.slideIndex)}>
|

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.