easy-slider
v1.0.2
Published
A simple carousel works without frameworks, tiny size and easy to use.
Downloads
3
Readme
easy-slider
A simple carousel works without frameworks, tiny size and easy to use. Support commonly used desktop browsers include IE10, and commonly used mobile broswers.
Install
npm i easy-slider
Usage
import EasySlider from "easy-slider";
/**
* @constructor
* @description Sets the selector and options, then return the instance
* @param selector {String} The selector string of the entry node
* @param config {Object} Component configuration object
*/
var easySlider = new EasySlider('.simple-carousel', {
loop: true,
initialSlide: 0
});
Documentation
Configuration
Check the available configuration list:
| Parameter | Type | Default | Description | | ---------- | ----------- | ----------- | ----------- | | debug | boolean | false | Open debug info (indevelopemnt) | | initialSlide | number | 0 | Set initial slide index (start with 0) | | speed | number | 300 | Slide animation duration (in ms) | | loop | boolean | false | Set to true to enable continuous loop mode | | effect | string | 'slide' | Tranisition effect. Only support "slide" for now |
Methods
We provide usefull methods to play with for EasySlider instance.
| Methode name | Discription | | ---------- | -----------| | slideTo(index) | Go to the 'index'th slide | | slideNext() | Go to next slide | | slidePrev() | Go to previous slide | | on(event, callback) | add event listener | | off(event, callback) | remove evet listener |
Event
We provide event hander to track the component behaviour instead of callbacks.
var easySlider = new EasySlider('.simple-carousel');
// add event handler
var initHandler = () => console.log('init');
easySlider.on('init', initHandler);
// remove event handler
easySlider.off('init', initHandler);
Note: this
keyword within event handler always points to EasySlider instance
| Event name | Arguments | Description | | ---------- | -----------| -----------| | init | | Call after slider initialized | | slideChange | | Call after slider changed