Skip to content

Most modern mobile touch slider with hardware accelerated transitions for ReactJS

License

Notifications You must be signed in to change notification settings

urasmel/bear-react-carousel

 
 

Repository files navigation

Bear React Carousel

Bear React Carousel Logo

Most modern slider with hardware accelerated transitions for ReactJS

NPM npm downloads npm npm

Documentation

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
  • Number of times to avoid re-renders by key in carousel items or switch memo cache
  • There is no need to set the style of the project, Bear 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 13 (v4.0.14+)

Installation

yarn add bear-react-carousel

Usage

import BearCarousel, {TBearSlideItemDataList, BearSlideImage} from 'bear-react-carousel';
import 'bear-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: TBearSlideItemDataList = images.map(row => {
    return {
        key: row.id,
        // BearSlideImage or BearSlideCard
        children: <BearSlideImage imageUrl={row.imageUrl}/>
    };
});

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

There is also a codesandbox template that you can fork and play with it:

Edit react-editext-template

Use Nextjs example

Edit react-editext-template

License

MIT © imagine10255

About

Most modern mobile touch slider with hardware accelerated transitions for ReactJS

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 95.1%
  • CSS 3.9%
  • Other 1.0%