@degjs/numericycle
v2.0.0
Published
Animate between two numbers
Downloads
46
Readme
numericycle
Numericycle is a Javascript module that animates a number from one value to another. It takes advantage of Window.requestAnimationFrame to produce smooth animations. Numericycle can be easily configured for animation duration, easing, and number display format.
Install
Numericycle is an ES6 module. Consequently, you may need a transpiler (Babel is a nice one) to compile numericycle into compatible Javascript for your runtime environment.
If you're using NPM, you can install numericycle with the following command:
$ npm install @degjs/numericycle
Usage
Import numericycle, create a new instance of it, and get cyclin'.
import numericycle from '@degjs/numericycle';
const element = document.querySelector('div');
const instance = numericycle(element);
instance.cycle({
initialValue: 1,
finalValue: 10,
duration: 2000,
easing: 'easeOut',
format: '0,0'
});
Parameters
element
Type: HTMLElement
The HTML element that contains or will contain the number to be animated.
Methods
.cycle(options)
Parameters: options
Animates the content of the HTML element using the values specified in the options
parameter:
options.initialValue
Type: Number
The initial value of the number. If this option is omitted, numericycle will attempt to convert the content of the HTML element to a number.
options.finalValue
Type: Number
The final value of the number. This option is required.
options.duration
Type: Number
Default: 2000
The duration (in milliseconds) of the animation.
options.easing
Type: String
Default: easeOut
The type of easing that the animation should use. Valid options are linear
, easeIn
, easeOut
, and easeInOut
.
options.format
Type: String
Default: 0,0
The display format for the number. Valid options are 0,0
(thousands separator included) and 0
(thousands separator omitted)
Browser Support
Numericycle works on modern browsers. To support legacy browsers, you'll need to include polyfills for the following Javascript APIs: