Skip to content
Animated slider/carousel component for react
JavaScript CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Use npm instead of yarn Nov 13, 2018
src Handle dynamic children Oct 18, 2018
.babelrc Upgrade babel Oct 18, 2018
.eslintrc.json Eslint update fixes Jul 4, 2018
.gitignore Add github pages config Apr 18, 2018
LICENSE Add MIT license Dec 2, 2017 SSL May 6, 2018
jest.config.js Add tests Dec 2, 2017
package-lock.json Update deps Nov 13, 2018
package.json Update deps Nov 13, 2018
postcss.config.js Fix line endings Dec 1, 2017
webpack.config.js Upgrade babel Oct 18, 2018
webpack.config.pages.js Code highlight May 3, 2018


npm version downloads Greenkeeper badge CircleCI dependencies devDependencies

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

Demo - Codesandbox Playground



  • 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


npm install react-animated-slider --save

Most Simple Use:

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

  {, index) => <div key={index}>


slideIndex - number, default 0

Index of the slide that will be initially displayed.

duration - number, default 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, default false

Disable slider navigation

infinite - boolean, default true

Enable or disable infinite loop through slides. Sliders with only 2 children will have this option set to false

autoplay - number, default 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, default false

Disable slider navigation through touch events

minSwipeOffset - number, default 15(px)

Minimum distance to swipe for triggering a navigation event

previousButton - ReactElement, default is an arrow svg

Will be rendered inside the previous button

nextButton - ReactElement, default is an arrow svg

Will be rendered inside the next button

onSlideChange - function, called after the current slide has changed; receives an object with the new slide index as argument:

<Slider onSlideChange={event => console.log(event.slideIndex)}>

classNames object, default

  slider: 'slider',
  previousButton: 'previousButton',
  nextButton: 'nextButton',
  buttonDisabled: 'disabled',
  track: 'track',
  slide: 'slide',
  hidden: 'hidden',
  previous: 'previous',
  current: 'current',
  next: 'next',
  animateIn: 'animateIn',
  animateOut: 'animateOut',

Object representing the CSS classNames that will be apllied to the slides.


slider the classname for the whole Slider element

previousButton previous button

nextButton next button

buttonDisabled disabled state for previous and next button

track element wrapping all slides

slide apllied to every item (child)

hidden a slide that is not visible and is not adjacent to the current slide, therefore no animation will be usually needed

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

You can’t perform that action at this time.