React Carousel with Server Side Rendering Support - Part 1

React Carousel with Server Side Rendering Support - Part 1

11 March, 2019
React Carousel with Server Side Rendering Support - Part 1

With this article I am going to show you how you can create your own Carousel component using React that supports multiple items and server-side rendering and add testing to it and finally publish to NPM.

This is part one of the series "React Carousel with Server Side Rendering Support". Part two can be found at w3js.

If you prefer to jump right to the code, i have made two versions of the Carousel, first version is the one we will be building in this tutorial with basic usage and the bare minimal amount of code that's easier for you to understand and beginner friendly. For the second version, it is made as a npm package which is an improved version of the first one with more advanced usage.

The source code for the Carousel we are building is here on Github. The Carousel npm package with more advanced usage.


  • Why build a Carousel component?
  • Common technical approach
  • The Carousel we are building
  • Technical approach we are going to use

Why build a Carousel component?

  1. The problem with most of the Carousel components out there nowadays are either built with Jquery(84.6kb of bundle size) or only supports client-end rendering. It means our content will be completely empty for the initial load and this will have an impact on the performance and user-experience as well as SEO. (I will explain why in the following section).
  2. Server-side rendering has already been a leading force in building front-end applications, especially with the rise of frameworks like Nextjs, there's often a need to implement a Carousel component to show case for instance a list of products or a list of articles on your website while keeping the performance and SEO up.

Common technical approach

One of the most common ways to building a Carousel component is to calculate the entire width of the Carousel component and divided by the amount of items you want to show will eventually be the average width of item inside the Carousel. After all the items are rendered nicely, the navigation are usually done by changing the "transform" property of the Carousel container with either "translateX" or "translate3d" with some math calculations as the following code snippets:

const itemsToShow = 4;
const containerWidth = document.getElementById("#container").offsetWidth;
const itemWidth = containerWidth / 4;
    <item1 style="width=itemWidth" />
    <item2 style="width=itemWidth" />
    <item3 style="width=itemWidth" />

The problem with this approach is that we don't have access to the actual window object and the width and height of the Carousel component on server-side. So what's gonna happen is that our user will see complete blank content at the beginning, and after some amount of time our browser finished downloading and executing the JavaScript codes to finally gain access to the dom, it will trigger a re-rendering and fix up our Carousel items. The following diagram will be a clearer illustration:

The Carousel we are building


  1. Supports showing multiple items at the same time.
  2. Supports sliding items to items.
  3. Support infinite sliding.
  4. Support server side rendering.

Technical approach

Here is the approach that we will be using, don't worry if you don't completely understand, but you will learn about it more once we get to the implementation step by step later.

  1. Pre-define the numbers of items we are showing at the same time at each break point.
  2. On the server-side we will be detecting the user's device type based on the user agent which comes with the request header usually can be either "mobile", "tablet" or "desktop".
  3. Do a comparison between the user's device type and our pre-defined break-point to determine the numbers of items we are showing at the same time.
  4. Divide the numbers of items by 100%, and ultimately setting the average of it to flex-basis to each item. For example, if we have decided to show 3 items after knowing the type of the user's device, then it means each item should take up 33% of the available space inside the container, by setting the flex-basis does exactly that. See code snippet below.
  5. After the initial load and when our browser has finished downloading our JavaScript code, we will trigger a re-rendering and switch to the most common approach that was mentioned at the beginning of this article which is to access our dom to get the total width of the container that's housing our carousel items.
const itemsToShowWhenOnServerSide = 3;
<CarouselItem style="flex-basis=33%" />

For our next post part two, we will be diving into the implementation with code.

React Carousel with Server Side Rendering Support – Part 2

Interested to see how to show case React components in storybook as your project's documentation? Follow my next article which is coming soon.