@itseasy21/react-elastic-carousel

A flexible and responsive carousel component for react, a fork of react-elastic-carousel

Why do we need yet another carousel component

• Element resize support (true responsiveness)
  Most of the carousel components are responsive to the viewport size, but this is not a real responsive support as we can have an element with a width:500px on a 1200px screen, most carousel component will "think" we are on a 1200px mode because they "watch" the view-port's size and not the wrapping element's size. This is the reason why react-eleastic-carousel is using the resize-observer which gives us a true responsive support, not matter on what screen size we are.

• RTL (right-to-left) support
  Supporting right-to-left languages requires a full support for right-to-left rendering and animations which is not supported in most of the carousel components out there. also, right-to-left support is important and should be a standard for most applications.

Live Demos & Docs

Install

npm install --save @itseasy21/react-elastic-carousel

or

yarn add @itseasy21/react-elastic-carousel

Requirements

• Node.js >= 16
• React 16.8.3 - 19
• React DOM 16.8.3 - 19
• Yarn 3.2.1 (for development)

Note

@itseasy21/react-elastic-carousel is using styled-components (v5 or v6) for styling, this means that you should install it as well:

npm install --save styled-components

Usage

import React, { Component } from 'react';
import Carousel from '@itseasy21/react-elastic-carousel';

class App extends Component {
  state = {
    items: [
      {id: 1, title: 'item #1'},
      {id: 2, title: 'item #2'},
      {id: 3, title: 'item #3'},
      {id: 4, title: 'item #4'},
      {id: 5, title: 'item #5'}
    ]
  }

  render () {
    const { items } = this.state;
    return (
      <Carousel>
        {items.map(item => <div key={item.id}>{item.title}</div>)}
      </Carousel>
    )
  }
}

Playground

Development

git clone https://github.com/itseasy21/react-elastic-carousel.git
cd react-elastic-carousel
corepack enable
yarn set version 3.2.1
yarn

To run the docs site run

yarn start

to run a demo Application run

yarn demo

The application is running at http://localhost:8888

Running tests

yarn test

Continuous Integration

This project uses GitHub Actions for CI/CD with the following workflows:

• Pull Request Checks: Linting, building, and testing with multiple React versions
• Build & Deploy: Automated build, test, and deployment on pushed to main/master branch

License

MIT © sag1v & itseasy21