@acrool/react-carousel

Acrool React Carousel

Most modern slider with hardware accelerated transitions for ReactJS

^5.2.0 support react >=18.0.0 <20.0.0

Documentation

• Getting Started
• Faq
• Prop Try
• ClassNames
• Components
• Features
• Examples
• Storybook

Features

• Use React + Flexbox directly, not javascript in secondary development into React
• Easier to use
• Use Flexbox instead of adding inline Style to carousel items
• There is no need to set the style of the project, Acrool React Carousel directly provides the components of your project, you only need to set the image URL and form an array, and put it in the data parameter.
• The size of the carousel, the height of the outer container is based, and the item container follows the size of the outer container
• The loop mode uses the cloning method to fill in the blanks at the beginning and end during cycling (If you try to change the order in the loop mode, you will encounter many issues)
• The onClick event inside the SlideItem will not be triggered during sliding, thereby avoiding potential user experience issues

Supports

• Supports both Web, Mobile
• Responsive setting parameters
• Navigation buttons can be directly moved out of the carousel area without being affected by overflow in simple usage situations
• Prevent onClick of carousel item from triggering on swipe
• Provide project scale setting + additional fixed size or fixed height setting
• Support two-way synchronous control of the second Carousel
• Support center mode
• Support auto play and init start play time
• Support keyboard control slide index
• Support lazy load image
• Support NextJS 14 (v14.1.0+)

Installation

yarn add @acrool/react-carousel

Usage

import AcroolCarousel, {TAcroolSlideItemDataList, AcroolSlideImage} from '@acrool/react-carousel';
import '@acrool/react-carousel/dist/index.css';

const images = [
    {id: 1, imageUrl: "https://dummyimage.com/900x400/dee2e6/6c757d.jpg"},
    {id: 2, imageUrl: "https://dummyimage.com/900x400/dee2e6/6c757d.jpg"},
    {id: 3, imageUrl: "https://dummyimage.com/900x400/dee2e6/6c757d.jpg"},
];
    
const data: TAcroolSlideItemDataList|undefined = images.map(row => {
    return <AcroolSlideImage
        key={row.id}
        imageUrl={row.imageUrl}
    />;
});

export const CustomBanner = () => {
    return <AcroolCarousel 
        data={data}
        height="200px"
    />
}

There is also a example that you can play with it:

License

MIT © Acrool