TUI

NumberGrow 数字滚动
用于展示数字动态增长动画的组件,适用于可视化看板、大屏数据展示、统计数字增长等场景。支持设置开始值、结束值、动画时长、小数精度、自定义步长等属性,支持懒加载与是否只播放一次的控制。
基础用法
默认从 0 增长到目标值,播放一次。
0
示例代码
vue
支持小数点与步长
通过设置 decimalsstep 支持小数增长效果。
0.00
示例代码
vue
懒加载模式
进入视口区域后自动播放一次动画,适合大屏滚动场景。
0
示例代码
vue
手动控制播放
通过绑定变量控制播放时机。
0
示例代码
vue
数字递减动画
演示数字从较大值递减至目标值的动画效果。可通过按钮控制是否播放。
100
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
duration
动画时长(秒)
number
-
2
start
起始值
number
-
0
value
目标值
number
-
0
play
是否播放动画(响应式控制)
boolean
-
false
decimals
小数精度
number
-
0
step
每帧步进大小
number
-
1
lazy
是否懒加载(进入视口播放)
boolean
-
false
playOnce
是否只播放一次(懒加载场景)
boolean
-
true
事件 Events
事件名
说明
回调参数
版本说明
start
动画开始触发, 仅在 lazy 为 true 时生效
-
end
动画播放完成触发
-
基础用法
支持小数点与步长
懒加载模式
手动控制播放
数字递减动画
属性 Props
事件 Events