Countdown 倒计时
uni-appH5微信小程序App
跨端倒计时组件,支持自动开始、暂停、重置和完成事件。
何时使用
限时场景:秒杀、验证码有效期、活动截止。
何时不使用
展示当前时间用普通文本 + 定时器;已过去的时点展示用相对时间。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
duration | number | - | 倒计时时长,单位毫秒(必填) |
format | string | "HH:mm:ss" | 时间格式,支持 DD / HH / mm / ss 占位;缺省大单位时小单位自动累计(如无 DD 则 HH 为总小时) |
autoStart | boolean | true | 挂载后自动开始 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
finish | void | 倒计时归零时触发 |
示例
基础用法
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>