1.1.2 • Published 2 years ago

@667/vue-number-animation v1.1.2

Weekly downloads
-
License
MIT
Repository
github
Last release
2 years ago

Animated Counter - Number VueJS v2.x compatible

This is a Vue number plugin. It animates the number that you pass in prop.

GitHub license npm icon

✔ Demo

https://codesandbox.io/s/8256nwlq78

✔ Installation

Get the package:

npm install vue-number-animation

✔ Use

Register Animate Number in your app:

import Vue from 'vue'
import VueNumber from 'vue-number-animation'

Vue.use(VueNumber)

In your Vue file you can call it like this:

<number
    ref="number1"
	:from="100"
	:to="10000"
	:format="theFormat"
	:duration="5"
    :delay="2"
    easing="Power1.easeOut"/>

<number
    tag="div"
    animationPaused
    ref="number2"
	:to="10000"
	:duration="5"
    easing="Back.easeIn"
    @complete="completed"
    @click="playAnimation"/>

<script>
export default {
    // Sets the format of the number
    methods: {
        theFormat(number) {
            return number.toFixed(2);
        },
        completed() {
            console.log('Animation ends!');
        },
        playAnimation() {
            this.$refs.number2.play()
        }
    }
}
</script>

API

Required Prop

PropertyDescriptionTypeDefault
toAnimation end pointNumber-

Optional Props

PropertyDescriptionTypeDefault
tagElement wrapperString'span'
fromAnimation start pointNumber0
durationDuration of the animation (seconds)Number1
delayAmount of delay (seconds) before the animation startsNumber0
easingEase of the animationString'Power1.easeOut'
animationPausedPauses animation at starting pointBooleanfalse

Easing prop

Choose from various eases to control the rate of change during the animation. These are all the values that the prop gets. https://greensock.com/docs/Easing

eases

Don't forget the '.' between ease name eg. Circ.easeInOut

Events

EventDescription
@startCalled when the animation has started
@completeCalled when the animation has completed
@updateCalled every time the animation updates (on every frame while the animation is active)

Methods

MethodDescription
play()Starts the animation
pause()Pauses the animation
restart()Restarts and begins playing forward from the beginning

✔ License

MIT