Cycle through the items of an array
This package can be useful for cycling through tabs, images of a slideshows, etc.
$ npm install cycled
const Cycled = require('cycled');
const cycled = new Cycled([1, 2, 3]);
cycled.current();
//=> 1
cycled.next();
//=> 2
cycled.next();
//=> 3
cycled.next();
//=> 1
cycled.previous();
//=> 3
Initiates an array subclass with the methods documented below. Since it's an array, you can use all the normal array methods on it.
Type: Array
The instance is an iterable that will cycle through the array. It will cycle through the number of elements equaling the length of the array from the current index.
const numberCycle = new Cycled([1,2,3,4,5]);
console.log(...numberCycle);
//=> 1 2 3 4 5
Returns the current item.
Returns the next item.
Returns the previous item.
Returns the item by going the given amount of steps
through the array. For example, calling steps(2)
is like calling next()
twice. You go backward by specifying a negative number.
Get or set the current index.
Returns an iterable that will cycle through the array indefinitely.
Returns an iterable that will cycle through the array backward indefinitely.
Here we create a simple tab component that can have the active view set or go forward/backward through the tabs.
const Cycled = require('cycled');
class TabComponent {
constructor(views) {
this.activeView = views[0];
this.views = new Cycled(views);
}
setActiveView(view) {
this.activeView = view;
this.views.index = this.views.indexOf(view);
}
nextView() {
setActiveView(this.views.next());
}
previousView() {
setActiveView(this.views.previous());
}
}
const tabs = new TabComponent([
'Homepage',
'Blog',
'Projects',
'Contact'
]);
// …
nextButton.addEventListener('click', () => {
tabs.nextView();
});
MIT © Sindre Sorhus