Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@eeacms/countup

eea1.9kMIT2.0.7TypeScript support: included

React component and hook to animate counting up or down to a number

react, reactjs, animate-numerical-value, animations, count-up, countup, react-count-up, react-countup, countdown, count-down, counting, hooks, eeacms

readme

EEA countup

Releases

Pipeline Lines of Code Coverage Bugs Duplicated Lines (%)

Pipeline Lines of Code Coverage Bugs Duplicated Lines (%)

This is a countup react library with the visibility observer already in it Also it has support for Volto addons pipeline, it is basically as an empty addon with tests

Installation

yarn add @eeacms/countup

Props

The component and the hook accept the same props. They are fully interchangeable.

Prop Name Type Default Description
isCounting boolean false Play and pause counting animation
start number 0 Initial value
end number - Target value
duration number - Animation duration in seconds. Defaults to 2 seconds if end is set
decimalPlaces number - Number of decimal places after the decimal separator.
decimalSeparator string - Decimal separator character
thousandsSeparator string - Thousands separator character
formatter function - Type: (value: number) => number | string | node
A function that formats the output value. It has the highest priority so all other formatting options are ignored
updateInterval number 0 Update interval in seconds. Determines how often the animated value will change. When set to 0 the value will update on each key frame
children function - Type: ({ value: number, reset: () => void }) => number | string | node
CountUp component - children prop
onComplete function - Type: () => void | {shouldRepeat: boolean, delay: number}
On complete handler. Repeat animation by returning an object with shouldRepeat equals true and delay in seconds.
onUpdate function - Type: (currentValue: number | string | node) => void
On value update event handler

Return values

The hook returns the current count up value and reset method to reset the animation.

import { useCountUp } from 'use-count-up';

const { value, reset } = useCountUp({ isCounting: true });

Release

See RELEASE.md.

How to contribute

See DEVELOP.md.

The Initial Owner of the Original Code is European Environment Agency (EEA). All Rights Reserved.

See LICENSE.md for details.

Funding

European Environment Agency (EU)

changelog

Changelog

All notable changes to this project will be documented in this file. Dates are displayed in UTC.

Generated by auto-changelog.

2.0.7 - 8 April 2025

:rocket: New Features

  • feat: add element type to render #refs286068 [nileshgulia1 - 2780fe1]

:bug: Bug Fixes

  • fix: add eslintrc.js [nileshgulia1 - fa22b78]

:hammer_and_wrench: Others

  • put back stylelint [nileshgulia1 - 8e78565]
  • update makefile [nileshgulia1 - 98bec92]
  • comment stylelint [nileshgulia1 - 13e355b]
  • dockerfile [nileshgulia1 - 4baf320]
  • update jenkinsfile [nileshgulia1 - 04fdcfe]

    2.0.6 - 29 September 2023

:bug: Bug Fixes

  • fix: Fix latest broken release [Alin Voinea - 812025c]

2.0.5 - 29 September 2023

:house: Internal changes

  • chore: Update package.json scripts to use Makefile; fix i18n [Alin Voinea - 7faa3a7]

:house: Documentation changes

  • docs: Update [Alin Voinea - 5dc1773]

:hammer_and_wrench: Others

  • test: Jenkinsfile disable not working steps [Alin Voinea - ce5521d]
  • i18n: Add en [Alin Voinea - 4a3f8fe]

    2.0.4 - 5 July 2023

:hammer_and_wrench: Others

  • releae [Dobricean Ioan Dorian - 99a1f24]
  • release [Dobricean Ioan Dorian - 648d5b2]
  • resolve conflicts [Dobricean Ioan Dorian - eab7573]
  • bump [Dobricean Ioan Dorian - f265f02]
  • curent [Dobricean Ioan Dorian - f4d4fcb]
  • update releases [Dobricean Ioan Dorian - 5f470aa]

    2.0.3 - 5 July 2023

:hammer_and_wrench: Others

  • release [Dobricean Ioan Dorian - f9caebf]
  • fix [Dobricean Ioan Dorian - 716ebaa]
  • better exemple [Dobricean Ioan Dorian - f83a485]

    2.0.2 - 5 July 2023

:hammer_and_wrench: Others

  • f [Dobricean Ioan Dorian - 13df0df]
  • make ok [Dobricean Ioan Dorian - 44c056f]
  • make ok [Dobricean Ioan Dorian - 7902e6d]

    2.0.1 - 5 July 2023

:hammer_and_wrench: Others

  • Update useCountUp.jsx [dobri1408 - f3185e6]
  • use intersection [Dobricean Ioan Dorian - 5c2100e]
  • try [Dobricean Ioan Dorian - 3574052]
  • new release [Dobricean Ioan Dorian - 9f5068b]
  • final and stable version [Dobricean Ioan Dorian - cd3bb03]

    2.0.0 - 4 July 2023

:hammer_and_wrench: Others

  • remove [Dobricean Ioan Dorian - 538f601]
  • gitignore [Dobricean Ioan Dorian - 0e82853]
  • fix conflic [Dobricean Ioan Dorian - 6b11c1e]
  • remove git actions [Dobricean Ioan Dorian - 76c9216]
  • remove git actions [Dobricean Ioan Dorian - 146e162]
  • new version [Dobricean Ioan Dorian - e420fb0]

    1.0.5 - 4 July 2023

:hammer_and_wrench: Others

  • release [Dobricean Ioan Dorian - 17f74f3]
  • remove dist [Dobricean Ioan Dorian - 3c75958]
  • remove dist [Dobricean Ioan Dorian - 56b24fb]
  • hho [Dobricean Ioan Dorian - fa692d5]
  • hho [Dobricean Ioan Dorian - 04d347c]
  • hook [Dobricean Ioan Dorian - efbb213]
  • hook [Dobricean Ioan Dorian - 5f7439a]

    1.0.4 - 3 July 2023

:hammer_and_wrench: Others

  • release [Dobricean Ioan Dorian - eee2f38]

    1.0.3 - 2 July 2023

1.0.2 - 2 July 2023

:hammer_and_wrench: Others

  • push [Dobricean Ioan Dorian - dc5c836]
  • check [Dobricean Ioan Dorian - c638c8e]

    1.0.1 - 2 July 2023

:hammer_and_wrench: Others

  • fix a bug [Dobricean Ioan Dorian - 2035889]

    1.0.0 - 2 July 2023

:hammer_and_wrench: Others

  • first stable version [Dobricean Ioan Dorian - d65201f]
  • test [Dobricean Ioan Dorian - 436b144]
  • dev [Dobricean Ioan Dorian - e89f8d8]
  • add test library [Dobricean Ioan Dorian - 7b8d1c9]
  • test [Dobricean Ioan Dorian - 1bfdfb9]

    0.4.1-beta - 1 July 2023

:hammer_and_wrench: Others

:hammer_and_wrench: Others

  • release [Dobricean Ioan Dorian - be44931]
  • final version [Dobricean Ioan Dorian - 9d07237]
  • fix confilicts [Dobricean Ioan Dorian - 8cbce3a]
  • remove not needed depend [Dobricean Ioan Dorian - d9ef6b8]
  • resolver [Dobricean Ioan Dorian - 413d32b]
  • babel [Dobricean Ioan Dorian - 3b683b2]
  • sd [Dobricean Ioan Dorian - cbcaed3]
  • delte exemple [Dobricean Ioan Dorian - e3cdeaa]
  • babel [Dobricean Ioan Dorian - ab68092]
  • try [Dobricean Ioan Dorian - d336ca3]
  • eslint [Dobricean Ioan Dorian - d321001]
  • countup [Dobricean Ioan Dorian - dfa61ae]

    0.3.9-beta - 1 July 2023

0.3.8-beta - 1 July 2023

:hammer_and_wrench: Others

  • release [Dobricean Ioan Dorian - 207b284]
  • dsds [Dobricean Ioan Dorian - 0bf5eee]
  • dsd [Dobricean Ioan Dorian - cf271ab]
  • fix tests [Dobricean Ioan Dorian - a8a8f34]
  • remove depend [Dobricean Ioan Dorian - 9a333fa]
  • fara dependinte [Dobricean Ioan Dorian - 54b4fea]
  • remove unesecery [Dobricean Ioan Dorian - c4991ff]
  • change name [Dobricean Ioan Dorian - 799a962]
  • dsds [Dobricean Ioan Dorian - 13ce7c8]
  • dds [Dobricean Ioan Dorian - 3bb27b7]
  • dpe [Dobricean Ioan Dorian - 2952e66]
  • devdepen [Dobricean Ioan Dorian - 3feb1ce]
  • countup [Dobricean Ioan Dorian - f8d4b85]
  • index.js [Dobricean Ioan Dorian - af65c35]
  • babel [Dobricean Ioan Dorian - 36b7cdf]
  • config [Dobricean Ioan Dorian - 8623353]
  • plugins [Dobricean Ioan Dorian - 0b66fce]
  • test [Dobricean Ioan Dorian - 43fe6aa]
  • add razzle [Dobricean Ioan Dorian - c4d49bb]
  • jest addon config [Dobricean Ioan Dorian - 25f8136]
  • jest addon config [Dobricean Ioan Dorian - 50bd4de]
  • add missing depen [Dobricean Ioan Dorian - 1f06508]
  • check unit tests [Dobricean Ioan Dorian - e8cf955]
  • check unit tests [Dobricean Ioan Dorian - c9ca893]
  • fix lint [Dobricean Ioan Dorian - 715c281]

    0.3.7-beta - 29 June 2023

0.3.6-beta - 28 June 2023

:hammer_and_wrench: Others

:hammer_and_wrench: Others

:hammer_and_wrench: Others

  • change node version [Dobricean Ioan Dorian - 283de56]
  • change node version [Dobricean Ioan Dorian - 1350e1f]

    0.3.1-beta - 28 June 2023

:hammer_and_wrench: Others

  • remove release [Dobricean Ioan Dorian - 592b01f]
  • prepublish [Dobricean Ioan Dorian - 033a2f1]

    0.3.0-beta - 28 June 2023

0.2.9-beta - 28 June 2023

:hammer_and_wrench: Others

  • remove dist [Dobricean Ioan Dorian - a264cd4]
  • change the main [Dobricean Ioan Dorian - 15606b9]

    0.2.8-beta - 28 June 2023

:hammer_and_wrench: Others

:hammer_and_wrench: Others

  • change name of main [Dobricean Ioan Dorian - d80912a]
  • change name of main [Dobricean Ioan Dorian - e0082a1]

    0.2.6-beta - 28 June 2023

:hammer_and_wrench: Others

:hammer_and_wrench: Others

:hammer_and_wrench: Others

:hammer_and_wrench: Others

:hammer_and_wrench: Others

:hammer_and_wrench: Others

  • release [Dobricean Ioan Dorian - 16a6ac7]
  • remove babel [Dobricean Ioan Dorian - 2913455]
  • remove babel [Dobricean Ioan Dorian - 4802e77]

    0.2.0-beta - 27 June 2023

:hammer_and_wrench: Others

  • sonorqube [Dobricean Ioan Dorian - c1137e8]
  • remove cypress [Dobricean Ioan Dorian - fa3463b]
  • release test [Dobricean Ioan Dorian - db4225d]
  • release [Dobricean Ioan Dorian - 3c42b70]

    v0.0.3-beta - 26 June 2023

:hammer_and_wrench: Others

  • volto-addon [Dobricean Ioan Dorian - 3dc9140]
  • transform in volto addon [Dobricean Ioan Dorian - 31a0808]
  • eslint [Dobricean Ioan Dorian - 1a12727]
  • eslint [Dobricean Ioan Dorian - 9b21a98]
  • eslint [Dobricean Ioan Dorian - f7bf43e]
  • project.eslintrc [Dobricean Ioan Dorian - 3b0c1fd]
  • remove voltoci [Dobricean Ioan Dorian - 705ccab]
  • remove voltoci [Dobricean Ioan Dorian - 71045fc]
  • added react as dependendency [Dobricean Ioan Dorian - de3fa1d]
  • lints [Dobricean Ioan Dorian - e74e1c3]
  • develop [Dobricean Ioan Dorian - 44da025]

    0.0.2 - 26 June 2023

:hammer_and_wrench: Others

  • Release 0.0.2 [Dobricean Ioan Dorian - 90888cb]
  • release [Dobricean Ioan Dorian - e8aa8c2]
  • Delete useKonamiCode.js [dobri1408 - e79cc2e]
  • stories [Dobricean Ioan Dorian - 356cfb4]

    v0.0.2-beta - 25 June 2023

:hammer_and_wrench: Others

  • author [Dobricean Ioan Dorian - ad3a92b]

    v0.0.1-beta - 25 June 2023

:hammer_and_wrench: Others

  • author [Dobricean Ioan Dorian - d4ee7a6]
  • first commit [Dobricean Ioan Dorian - 01d77c3]
  • first commit [Dobricean Ioan Dorian - a3bce97]