跳到主要内容

Countdown 倒计时 ​

WebH5

倒计时。按给定毫秒时长倒数,250ms 间隔校正渲染,等宽数字;支持 DD/HH/mm/ss 格式化与 start/pause/reset 实例方法。

何时使用 ​

限时场景:秒杀、验证码有效期、活动截止。

何时不使用 ​

展示当前时间用普通文本 + 定时器;已过去的时点展示用相对时间。

Props ​

名称类型默认值说明
durationnumber-倒计时时长,单位毫秒(必填)
formatstring"HH:mm:ss"时间格式,支持 DD / HH / mm / ss 占位;缺省大单位时小单位自动累计(如无 DD 则 HH 为总小时)
autoStartbooleantrue挂载后自动开始

Events ​

名称载荷说明
finish-倒计时归零时触发

示例 ​

基础 ​

示例加载中…

自定义格式(含天数) ​

示例加载中…

结束回调 + 状态回显 ​

示例加载中…

暂停、继续与重置(实例方法) ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Countdown 文档(含手机预览)。