跳到主要内容

Countdown 倒计时 ​

uni-appH5微信小程序App

跨端倒计时组件,支持自动开始、暂停、重置和完成事件。

何时使用 ​

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

何时不使用 ​

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

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Countdown 倒计时 · uni-app H5 实时运行 新窗口打开

Props ​

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

Events ​

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

示例 ​

基础用法 ​

vue
<Countdown :duration="3600" />

分秒格式 ​

vue
<Countdown :duration="300" format="mm:ss" />

结合文案 ​

vue
<view class="row">
  <Text variant="secondary">支付剩余时间</Text>
  <Countdown :duration="900" format="mm:ss" />
</view>