Skip to content

CountTo 数字滚动1.3.8

基本用法

设置 endVal 属性,表示最终值。 设置 startVal 属性,表示起始值。 设置 duration 属性,表示从起始值到结束值数字变动的时间。 设置 autoplay 属性,表示是否自动播放。 设置 decimals 属性,表示保留的小数位数。 设置 decimal 属性,表示小数点符号。 设置 prefix 属性,表示数字前缀。 设置 suffix 属性,表示数字后缀。 设置 fontSize 属性,表示字体大小。 设置 color 属性,表示文本颜色。

vue
<wd-count-to :endVal="2024" suffix="年" color="#16baaa"></wd-count-to>
<wd-count-to prefix="¥" :startVal="0" :decimals="2" :endVal="186.321" :fontSize="32" suffix="%" color="#1e9fff"></wd-count-to>
<wd-count-to prefix="¥" :startVal="0" :decimals="2" :endVal="21286.321" :fontSize="32" suffix="%" color="#ff5722"></wd-count-to>
<wd-count-to prefix="¥" :startVal="0" :decimals="2" :endVal="21286.321" :fontSize="32" suffix="%" color="#ffb800" :duration="2000"></wd-count-to>

设置主题

通过type参数设置文本主题,我们提供了五类属性:primary error success warning default-默认

html
<wd-count-to type="primary" prefix="¥" :startVal="0" :endVal="888888" suffix="%"></wd-count-to>
<wd-count-to type="error" prefix="¥" :startVal="0" :endVal="888888" suffix="%"></wd-count-to>
<wd-count-to type="success" prefix="¥" :startVal="0" :endVal="888888" suffix="%"></wd-count-to>
<wd-count-to type="warning" prefix="¥" :startVal="0" :endVal="888888" suffix="%"></wd-count-to>
<wd-count-to type="info" prefix="¥" :startVal="0" :endVal="888888" suffix="%"></wd-count-to>

手动控制

通过 start 方法开始倒计时,通过 pause 方法暂停倒计时,通过 reset 方法重置倒计时。

html
<wd-count-to
  ref="countTo"
  :auto-start="false"
  prefix="¥"
  :startVal="1000"
  :decimals="3"
  :endVal="9999.32"
  :fontSize="32"
  suffix="%"
  color="#1e9fff"
></wd-count-to>
<wd-grid clickable border>
  <wd-grid-item text="开始" icon="play-circle-stroke" @itemclick="start" />
  <wd-grid-item text="暂停" icon="pause-circle" @itemclick="pause" />
  <wd-grid-item text="重置" icon="refresh" @itemclick="reset" />
</wd-grid>
ts
import type { CountToInstance } from '@/uni_modules/wot-design-uni/components/wd-count-to/types'

const countTo = ref<CountToInstance>()

const start = () => {
  countTo.value!.start()
}
const pause = () => {
  countTo.value!.pause()
}
const reset = () => {
  countTo.value!.reset()
}

Attributes

参数说明类型可选值默认值最低版本
fontSize字体大小number16default1.3.8
color文本颜色string-''1.3.8
type主题类型string'primary' / 'error' / 'warning' / 'success'default1.3.9
startVal起始值number-01.3.8
endVal最终值number-20241.3.8
duration从起始值到结束值数字变动的时间number-30001.3.8
autoplay是否自动播放boolean-true1.3.8
decimals保留的小数位数number(需大于等于 0)01.3.8
decimal小数点符号string-'.'1.3.8
separator三位三位的隔开效果string-','1.3.8
prefix前缀string--1.3.8
suffix后缀string--1.3.8
useEasing是否具有连贯性boolean-true1.3.8

Events

事件名称说明参数最低版本
finish动画完成时触发1.3.8
mounted组件加载完成时时触发-1.3.8

Methods

方法名说明参数最低版本
start开始动画1.3.8
pause暂停动画1.3.8
reset重置动画,若 auto-starttrue,重设后会自动开始倒计时1.3.8

Slots

名称说明最低版本
default默认插槽1.3.8
prefix前缀插槽1.3.8
suffix后缀插槽1.3.8

外部样式类

类名说明最低版本
custom-class根节点样式1.3.8
custom-style根节点样式1.3.8

源代码

文档
组件

Released under the MIT License.

Released under the MIT License.