Navigate back to the homepage
Browse Repo

Build an elegant gallery with React-Responsive-Carousel

Godwin Chinda
July 21st, 2022 · 4 min read

A Carousel or slider, as the case may be, is an essential way of displaying multiple images or content in a single space. It helps minimize screen space, encourages visitors to focus on the importance of the website/app content, and improves the overall visual interest efficiently. There are various ways to implement Carousels in React, which will be discussed in this article.

React-Responsive-Carousel is a Javascript/React package used on frontend applications to show image/video galleries, sell products and show related blogs. The Carousel component provides a way to create a slideshow for our images or text slides in a presentable manner in a cyclic way. It enhances the ability to create a gallery for most web applications in today’s world.

Let’s look at a React-Responsive-Carousel Template code to understand how our carousel works with the demo application.

1import React, { Component } from 'react';
2import ReactDOM from 'react-dom';
3import "react-responsive-carousel/lib/styles/carousel.min.css"; // requires a loader
4import { Carousel } from 'react-responsive-carousel';
6class DemoCarousel extends Component {
7 render() {
8 return (
9 <Carousel>
10 <div>
11 <img src="assets/1.jpeg" />
12 <p className="legend">Legend 1</p>
13 </div>
14 <div>
15 <img src="assets/2.jpeg" />
16 <p className="legend">Legend 2</p>
17 </div>
18 <div>
19 <img src="assets/3.jpeg" />
20 <p className="legend">Legend 3</p>
21 </div>
22 <div>
23 <img src="assets/4.jpeg" />
24 <p className="legend">Legend 4</p>
25 </div>
26 <div>
27 <img src="assets/5.jpeg" />
28 <p className="legend">Legend 5</p>
29 </div>
30 <div>
31 <img src="assets/6.jpeg" />
32 <p className="legend">Legend 6</p>
33 </div>
34 </Carousel>
35 );
36 }
39ReactDOM.render(<DemoCarousel />, document.querySelector('.demo-carousel'));
41//Don't forget to include the CSS in your page
43// Using webpack or parcel with a style loader
44// import styles from 'react-responsive-carousel/lib/styles/carousel.min.css';
46// Using html tag:
47// <link rel="stylesheet" href="<NODE_MODULES_FOLDER>/react-responsive-carousel/lib/styles/carousel.min.css"/>


These are the important features of this library.

  • Mouse emulating touch: The system emulates the event click on the mouse when it has been touched to loop over to the next slide
  • Responsive: Response effectively to the behavior of the device and its screen size
  • Custom Animation: Implement Individual Custom Animation
  • Infinite Loop: This means we could go back to the initial item we started when we clicked on next.
  • Keyboard Navigation: Manually using the keyboard to navigate between items/slides of the Carousel
  • Compatible with Server-Side Rendering: Compatible with the Server-Side application.
  • Horizontal and Vertical Directions: Movements both horizontally and vertically; i.e., we can go from left to right or up to down and vice versa as the case may be.
  • Supports External Controls: Supports external devices for control, such as an external mouse for navigation.
  • Multiple File Format: Support photos, videos, text content, and whatever else you can think of; Each direct child corresponds to a single slide.
  • Extremely Adaptable: Ability to adapt to new features integrated into it with other components

The most significant advantage of employing Carousels is that they allow multiple pieces of information to share the same prime real space on the site. This can assist reduce infighting about whose material is most deserved. Another advantage is that because more information is displayed near the top of the viewable area, people may have more chances to see it.


React-Responsive-Carousel receives all the Carousel components as props (for example, each slide in our carousel will be passed as children, but for us to customize them, we need to use our renderItem prop). Let’s take a look at other props in our Carousel.

  • autoFocus: When the carousel renders, force the emphasis on it.
  • autoPlay: The slide will change automatically based on the interval prop.
  • onSwipeMove: A touch event is passed as an argument to a callback triggered on every movement while swiping.
  • onClickItem: The current index and item are passed as arguments to the callback to handle a click event on a slide.
  • centreMode: Set the slide width based on centerSlidePercentage and center the current item.
  • transitionTime: The transition time between slides. 350 is the default setting.
  • infiniteLoop: Enable the unlimited loop option for the carousel. Set to false by default.
  • centerMode: With next and previous set to half on the sides, centerMode displays the active slide in the center; this only operates on the horizontal axis.
  • labels: Change the labels for the item, Next, and Prev arrows.
  • showStatus: On the upper right, display the number of slides (current and total). Set to true by default.
  • showIndicators: The carousel’s bottom has dot navigation. Set to true by default.
  • showThumbs: Carousel picture thumbnails can be enabled or disabled. Set to true by default.
  • swipeable: Enable swiping while dragging. Set to true by default.
  • thumbWidth: The width of thumbnails can be customized.

Open Source Session Replay

OpenReplay is an open-source, session replay suite that lets you see what users do on your web app, helping you troubleshoot issues faster. OpenReplay is self-hosted for full control over your data.


Start enjoying your debugging experience - start using OpenReplay for free.

To put our knowledge into practice, we’ll create a slider app with our React-Responsive-Carousel. To do that, we will, first of all, create our React App.

Starting the project

First, we will create our React project using the npx create-react-app command.

1npx create-react-app slider-app

Now we move inside our slider-app directory and install our React-Responsive-Carousel package.

1cd slider-app
2npm install react-responsive-carousel --save
3npm start

Here, we’re going to create a new component, Gallery, which will be used as the main component in the application.

1// src/component/Gallery.js
2import React from "react";
3import "react-responsive-carousel/lib/styles/carousel.min.css"; // requires a loader
4import { Carousel } from 'react-responsive-carousel';
5class Gallery extends React.Component {
6 render() {
7 return (
8 <div>
9 <h2>My Photo Gallery</h2>
10 <Carousel autoPlay interval="5000" transitionTime="5000" infiniteLoop>
11 <div>
12 <img src="" alt="" />
13 <p className="legend">My Photo 1</p>
14 </div>
15 <div>
16 <img src="" alt="" />
17 <p className="legend">My Photo 2</p>
18 </div>
19 <div>
20 <img src="" alt="" />
21 <p className="legend">My Photo 3</p>
22 </div>
23 <div>
24 <img src="" alt="" />
25 <p className="legend">My Photo 4</p>
26 </div>
27 <div>
28 <img src="" alt="" />
29 <p className="legend">My Photo 5</p>
30 </div>
31 </Carousel>
32 </div>
33 )
34 };
36export default Gallery

In the code above, we have imported the Carousel function from react-responsive-carousel, which is wrapping the items of the image carousel. This will automatically create a Carousel Slider out of the items placed inside.

Also, we imported the carousel.min.css to add the required styling and animations to the carousel. To display our images, we’ve used online links to our photos from Unsplash. If you don’t want to do that or have your files locally stored, then you can place them in the public/assets folder.

All we have to do here is to import our already configured Gallery component in the App.js file as shown below;

1// App.js
2import './App.css';
3import Gallery from './component/Gallery';
4function App() {
5 return (
6 <div className="App">
7 <Gallery />
8 </div>
9 );
11export default App;

Here we have our already imported Gallery component. Now we can go back to our React application and see how we are holding up.


Our Application seems to be working, and now whenever we click on the Next button, we move on to the next image; if we click again, we move on to the next image, and so on. Next, for our app to work as a slider app, we need to implement an autoPlay function so that we can view our slide show without using the buttons, so we have implemented that on our app.

We’ll integrate an autoplay feature in the carousel by adding the autoplay property on the <Carousel> component. Then we add the interval property, which will define a space-time in milliseconds for an auto slide.

1<Carousel autoPlay interval="5000">

We’ll set our Carousel to move in either Horizontal or Vertical direction. And for that to happen, we’ll need to set the axis property to horizontal or vertical.

1<Carousel autoPlay axis="horizontal" >

And for our final implementation, we want our slides to start themselves again once it gets to the last image/video; i.e., our Carousel movement will be looped over once it gets to the end. To do that, we’ll be adding the infiniteLoop property below;

1<Carousel autoPlay axis="vertical" infiniteLoop>



React features a vast array of components for Carousel, which includes Swiper, React-Image-Gallery, not forgetting React-Responsive-Carousel among many others. They are well-liked by e-Commerce businesses and work on enhancing the app’s capabilities for e-Commerce websites and apps. Additionally, a React Carousel receives more interaction than other UI components. Because of this, every e-Commerce or shopping site has several carousels on its display.

Although making a React Carousel is laborious, the effort is not lost. Your React application has a seamless architecture. Additionally, you can construct Carousels quickly thanks to the availability of plugins and React libraries. The main drawback is that, in contrast to developing from scratch, you are not allowed to modify every aspect of a plugin. Click the link for the Source Code and also here for our live app.



More articles from OpenReplay Blog

Rendering real-time data with Vue, Node, and

Implementing a simple game to show how to process real-time data in Vue

July 21st, 2022 · 6 min read

JavaScript Types and Values, explained

An introduction to a most basic and important concept

July 20th, 2022 · 10 min read
© 2022 OpenReplay Blog
Link to $ to $ to $