首页 > 网络编程 > JavaScript > javascript类库 > vue.js > Vue3 vue-countup-v3

Vue3数字滚动插件vue-countup-v3的使用

2023-10-30 09:53:56 作者：I'm Jie

vue-countup-v3 插件是一个基于 Vue3 的数字动画插件，用于在网站或应用程序中创建带有数字动画效果的计数器，本文主要介绍了Vue3数字滚动插件vue-countup-v3的使用，感兴趣的可以了解一下

介绍

vue-countup-v3 插件是一个基于 Vue3 的数字动画插件，用于在网站或应用程序中创建带有数字动画效果的计数器。通过该插件，我们可以轻松地实现数字的递增或递减动画，并自定义其样式和动画效果。该插件可以用于许多场景，例如展示网站页面的访问量，展示应用程序的下载量，以及展示任何需要动态展示数字的场景等。

效果

该插件支持更多的参数自定义，比如数字的样式、动画的播放方向、循环播放等等。通过这些参数，可以实现更加丰富的数字动画效果。一个简单的效果如下：

安装

使用该插件需要安装依赖，可以通过 npm 命令进行安装：

npm i vue-countup-v3

属性

属性	类型	默认值	描述
endVal	Number \| String	-	结束值
startVal	Number \| String	0	起始值
duration	Number	2.5	动画时长，单位：秒
decimalPlaces	Number	0	小数点位数
autoplay	Boolean	true	是否自动计数
loop	Boolean \| Number	false	循环次数，有限次数 / 无限循环
delay	Number	0	loop 循环的间隔时间，单位：秒
options	Object	-	配置项

事件

时间	描述	返回值
@init	CountUp 实例初始化完成触发	CountUp 实例
@finished	计数结束时触发	-

配置项

配置项	类型	默认值	描述
startVal	number	0	开始数值
decimalPlaces	number	0	小数点位数
duration	number	2	动画时长，单位：秒
useGrouping	boolean	true	是否使用千位分隔符）显示
useIndianSeparators	boolean	false	是否使用印度数位分隔符
useEasing	boolean	true	是否开启数字增加过程中的缓动方式
smartEasingThreshold	number	999	设置一个阈值用于调整数字计数器的动画效果
smartEasingAmount	number	0.5	控制着数字变化的缓动效果
separator	string	,	千分位分隔符
decimal	string	.	小数点分隔符
easingFn	number	easeOutExpo	用于控制数字变化的缓动函数
formattingFn	string	-	用于格式化计数器的值
prefix	string	-	数值前缀
suffix	string	-	数值后缀
numerals	string[]	-	数字符号替换 0 - 9
enableScrollSpy	boolean	true	在可视范围内才开始动画
scrollSpyDelay	number	50ms	目标进入可视范围内后的延迟时间(毫秒)
scrollSpyOnce	boolean	false	滚动到该元素时执行数字滚动动画是否执行一次
onCompleteCallback	-	-	回调函数，可以在计数结束时执行
plugin	-	-	用于替换动画效果

完整样例

<script setup lang="ts">
  import { ref } from 'vue'
  import CountUp from 'vue-countup-v3'
  import type { ICountUp, CountUpOptions } from 'vue-countup-v3'
  
  const endValueRef = ref(2022.22)
  // coutup.js options
  const options: CountUpOptions = {
    separator: '❤️'
    // ...
  }
  let countUp: ICountUp | undefined
  const onInit = (ctx: ICountUp) => {
    console.log('init', ctx)
    countUp = ctx
  }
  const onFinished = () => {
    console.log('finished')
  }
</script>

<template>
  <count-up 
    :end-val="endValueRef"
    :duration="2.5"
    :decimal-places="2"
    :options="options"
    :loop="2"
    :delay="2"
    @init="onInit"
    @finished="onFinished"></count-up>
</template>

到此这篇关于Vue3数字滚动插件vue-countup-v3的使用的文章就介绍到这了,更多相关Vue3 vue-countup-v3 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Vue中使用vue-count-to(数字滚动插件)详细教程