TUI

CutDown 倒计时
支持格式化、精度控制、毫秒展示、暂停重启等功能。
基础用法
默认天、小时、分、秒。
示例代码
vue
进阶用法
展示自动开始、精度、单位、补零等。
示例代码
vue
事件监听
监听 change 和 end 事件。
示例代码
vue
方法调用
使用 ref 控制组件暂停、恢复、重置。
示例代码
vue
插槽用法
通过 slot 自定义展示结构,支持绑定 timeData 数据。
:
:
:
:
示例代码
vue
属性 Props
属性名
说明
类型
可选值
默认值
版本说明
etime
绑定值(毫秒)
number
-
-
autoStart
是否自动开始
boolean
-
true
precision
显示时间精度
string
days / hours / minutes / seconds
day
millisecond
是否显示毫秒
boolean | number
false / 1 / 2 / 3
false
format
格式化字符串
string
-
-
unit
单位分隔符
string
: / zh
:
padZero
是否补零
boolean
true / false
false
事件 Events
事件名
说明
回调参数
版本说明
change
值变化时触发,频率较高,谨慎调用
剩余时间(毫秒)
end
倒计时结束时触发
-
插槽 Slots
插槽名
说明
版本说明
default
自定义的插槽, 返回剩余时间对象,格式为 TimeObjectResult<number | string>, 会根据 padZero 返回 number | string
方法 Functions
方法名
说明
参数
返回值
版本说明
start
开始倒计时, autoStart 为 false 时可用, 仅在初始化或者重置后可调用
-
-
pause
暂停倒计时
-
-
resume
继续倒计时
-
-
reset
重置倒计时, 重置后 autoStart 为 false 可开始倒计时
-
-
TimeObjectResult Props
属性名
说明
类型
可选值
默认值
版本说明
total
总毫秒数
number | string
-
days
天数
number | string
-
hours
小时数
number | string
-
minutes
分钟数
number | string
-
seconds
秒数
number | string
-
milliseconds
毫秒数
number | string
-
基础用法
进阶用法
事件监听
方法调用
插槽用法
属性 Props
事件 Events
插槽 Slots
方法 Functions
TimeObjectResult Props