@intothesource/slider v1.2.4

@intothesource/slider

Slider for sliding things.

Example

<div data-its-slider>
    <div data-its-slider-slides-container>
        <div data-its-slider-slide> <!-- Slide 1 Content --> </div>
        <div data-its-slider-slide> <!-- Slide 2 Content --> </div>
        <div data-its-slider-slide> <!-- Slide 3 Content --> </div>
    </div>
    <button data-its-slider-button
        data-its-slider-button-prev
        data-its-slider-button-disabled
        disabled>prev</button>
    <button data-its-slider-button
        data-its-slider-button-next
        data-its-slider-button-disabled
        disabled>next</button>
</div>
<script src="slider.js"></script>
<script>
    var sliders = slider.Slider.init();
</script>

For a more complete example: See index.ejs.

Progressive enhancement

You'll want to make sure that the content of the slider doesn't jump around the page before the slider JS has fully loaded. To mitigate this, make sure to include the following CSS in your project CSS (or inline it on the page).

The following CSS is most of how this slider is supposed to work. The additional CSS and JS from this component is to make sure that the navigation buttons are activated/de-activated and scroll snapping is implemented for devices that support it.

[data-its-slider-slides-container] {
    display: flex;
    overflow-x: scroll;
    scrollbar-width: none;
    -ms-overflow-style: none;
}

[data-its-slider-slides-container]::-webkit-scrollbar {
    display: none;
}

@media (hover: none) and (pointer: coarse) {
    [data-its-slider-slides-container] {
        -webkit-overflow-scrolling: touch;
    }
}

The plugin adds a data-its-slider-enhanced attribute after it's been initialized. If you want to hide the navigation buttons until they're ready to use (or if JavaScript is even enabled):

[data-its-slider]:not([data-its-slider-enhanced]) [data-its-slider-button] {
    display: none;
}

Polyfill smooth scrolling

If you want Safari and IE to use smooth scrolling, you'll need to include a polyfill to your project.

<script 
    src="https://unpkg.com/smoothscroll-polyfill@0.4.4/dist/smoothscroll.js">
</script>

Building

$ npm run build

Publishing changes

$ npm version [patch|minor|major]
$ npm publish

Update the docs on https://intothesource.github.io/slider/

$ npm run deploy:gh-pages