/countUp.js

Animates a numerical value by counting to it

Primary LanguageJavaScriptMIT LicenseMIT

countUp.js

countUp.js is a dependency-free, lightweight JavaScript "class" that can be used to quickly create animations that display numerical data in a more interesting way.

Despite its name, countUp can count in either direction, depending on the startVal and endVal params that you pass. Bower and Component .json files are included, as well as a coffeescript version, thanks to @HHSnopek.

countUp.js supports all browsers.

##Try the demo

Usage:

Params:

  • target = id of html element or var of previously selected html element where counting occurs
  • startVal = the value you want to begin at
  • endVal = the value you want to arrive at
  • decimals = number of decimal places in number, default 0
  • duration = duration in seconds, default 2
  • options = (optional) object that determines number formatting and toggles easing - see demo
var numAnim = new countUp("SomeElementYouWantToAnimate", 24.02, 99.99, 2, 1.5);
numAnim.start();

with optional callback:

numAnim.start(someMethodToCallOnComplete);

Other methods:

Stop an animation in progress:

numAnim.stop();

Resume a stopped animation:

numAnim.resume();

Reset an animation:

numAnim.reset();