1.5.2 • Published 3 months ago

react-scroll-snap-anime-slider v1.5.2

Weekly downloads
-
License
MIT
Repository
github
Last release
3 months ago

Works natively on touchable devices

:grinning:Demo

:star: Features

FeaturesCommentStatus
Multiple slides per viewCan adjust multiple slides per step:heavy_check_mark:
Customized DOM structureConstruct the slider components by yourself:heavy_check_mark:
Customized slides marginMargin between each slide:heavy_check_mark:
Customized slide tray paddingOffset slide tray to see prev/next slide:heavy_check_mark:
Touch scrollingBuilt-in:heavy_check_mark:
Scroll and snapSnap to slide's edge:heavy_check_mark:
Free scrolling:heavy_check_mark:
Scroll with touch padBuilt-in:heavy_check_mark:
Scroll with keyboard < and >Built-in:heavy_check_mark:
Scroll with mouse dragScroll end with inheria effect:heavy_check_mark:
Scroll with mouse wheel:x:
Navigation ButtonsSupport multiple clicks:heavy_check_mark:
Dynamic scrollbar:heavy_check_mark:
Dynamic & Customizable dot groupCustomize using renderDots() callback:heavy_check_mark:
Bounce on boundaryBuilt-in on touchable devices:large_blue_circle:
Responsive styleBuilt-in:heavy_check_mark:
Customized StyleUse class-name or style to override basic style:heavy_check_mark:
Inifinite scrolling:x:
Auto playCan implement it by using Slider ref:x:
Vertical scrollingPending:clock3:

:neutral_face: Motivation

The reason to start creating my own JS slider is because I couldn't find a slider that works smoothly on both desktop browser and mobile device. There are a ton of wonderfull sliders out there such as Swiper, Pure React Carousel and a lot, but they are not utilizing the native scrolling feature, and so not work natively on iOS browser (the animation not works smoothly).

🤔 Do I need this slider?

If you are looking for an animation effect of slider that works like those sliders you saw in some native Apps, you can try this one. However this slider has limitions such as it only provides sliding effect (no fade, swiping effects, for example). So, if you are looking for a powerful slider, you should other powerful library such as Swiper.

:pushpin: Geting started

Install:

npm install react-scroll-snap-anime-slider

Create a simple slider:

import { ButtonBack, ButtonNext, Carousel, Slide, Slider, SliderBarLine } from "react-scroll-snap-anime-slider";

export function MySlider() {
    let total = 20;
    let visible = 3;
    let step = 3;

    return (
        <Carousel
            totalSlides={total}
            visibleSlides={visible}
            step={step}
        >
            <Slider>
                {new Array(total).fill(0).map((_, i) => {
                    return <Slide key={i}>
                        <div style={{ height: "100px", border: "1px solid #ccc", textAlign: "center" }}>slider# {i}</div>
                    </Slide>;
                })}
            </Slider>

            <SliderBarLine />

            <div style={{ textAlign: "center" }}>
                <ButtonBack>&lt;</ButtonBack>
                <ButtonNext>&gt;</ButtonNext>
            </div>

        </Carousel>
    );
}

:book: Documentation

You can learn more from here.

:bug: Bugs or :bow: Requests

You can file an issue under the Issues page.

1.5.2

3 months ago

1.5.1

10 months ago

1.5.0

10 months ago

1.4.1

10 months ago

1.4.0

10 months ago

1.3.7

11 months ago

1.3.6

11 months ago

1.3.5

11 months ago

1.3.4

11 months ago

1.3.3

11 months ago

1.3.2

11 months ago

1.3.1

11 months ago

1.3.0

11 months ago

1.2.0

11 months ago

1.1.0

11 months ago

1.0.1

11 months ago

1.0.0

11 months ago