Methods
All public methods available on a Slider instance.
Navigation
| Method | Description |
goTo(target) | Navigate to a slide. target can be a number (0-based index), 'next', 'prev', 'first', or 'last'. |
next() | Go to the next slide. Shorthand for goTo('next'). |
prev() | Go to the previous slide. Shorthand for goTo('prev'). |
const slider = new Slider('#my-slider', { loop: true })
slider.next()
slider.prev()
slider.goTo(2) // jump to slide 3 (0-based)
slider.goTo('last') // jump to last slide
Events
| Method | Description |
on(event, fn) | Subscribe to a slider event. fn receives a SliderInfo object. |
off(event, fn) | Unsubscribe the exact same function reference. |
emit(event, data?) | Manually emit an event on this slider instance. |
function onChanged(info) {
console.log('active slide:', info.displayIndex)
}
slider.on('indexChanged', onChanged)
// later
slider.off('indexChanged', onChanged)
Info
| Method | Description |
getInfo() | Returns a SliderInfo snapshot of the current slider state. |
Lifecycle
| Method | Description |
destroy() | Full teardown — removes clones, event listeners, injected CSS, ARIA attributes, and calls each plugin's destroy(). |
Properties
| Property | Type | Description |
activeIndex | number | Current 0-based slide index. |
currentItems | number | Currently active items count (respects responsive breakpoints). |
slideCount | number | Total number of real slides (no clones). |
isBeginning | boolean | true when on the first slide. |
isEnd | boolean | true when on the last slide. |
container | HTMLElement | The user's original container element. |
outerWrapper | HTMLElement | The outer wrapper injected by the slider. |
innerWrapper | HTMLElement | The inner wrapper (applies edge padding). |
slides | HTMLElement[] | All slide elements including clones. |
options | Required<SliderOptions> | Merged options object (base only, not responsive overrides). |