主题
CountDown 倒计时
根据剩余秒数显示倒计时,可选择显示天、时、分、秒和毫秒。
支持平台
以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。
| App-vue | App-nvue | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 | H5 | PC | 快手小程序 | 钉钉小程序 |
|---|---|---|---|---|---|---|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
基础用法
vue
<!-- 一小时倒计时 -->
<fui-count-down :value="3600" />属性
| 属性 | 类型 | 说明 | 官网默认值 |
|---|---|---|---|
| value | Number / String | 剩余时间,单位秒 | 0 |
| width | Number / String | 数字框宽度,单位 rpx,不含毫秒框 | 40 |
| height | Number / String | 数字框高度,单位 rpx | 40 |
| borderColor | String | 数字框边框颜色 | #333 |
| background | String | 数字框背景色 | #fff |
| size | Number / String | 数字字号,单位 rpx | 28 |
| color | String | 数字颜色 | #333 |
| colonSize | Number / String | 分隔符或单位字号,单位 rpx | 28 |
| colonColor | String | 分隔符或单位颜色 | #333 |
| isDays | Boolean | 是否显示天数 | false |
| isHours | Boolean | 是否显示小时 | true |
| isMinutes | Boolean | 是否显示分钟 | true |
| isSeconds | Boolean | 是否显示秒数 | true |
| unitEn | Boolean | 是否使用 d、h、m、s 作为单位 | false |
| isMs | Boolean | 是否显示毫秒 | false |
| msWidth | Number / String | 毫秒数字框宽度,单位 rpx | 36 |
| msSize | Number / String | 毫秒字号,单位 rpx | 24 |
| msColor | String | 毫秒颜色,未设置时使用 color | - |
| isColon | Boolean | 时分秒是否用冒号分隔 | true |
| returnTime | Boolean | 是否通过 time 事件返回剩余时间 | false |
| autoStart | Boolean | 是否自动开始 | true |
事件
| 事件 | 说明 | 回调参数 |
|---|---|---|
| end | 倒计时结束时触发 | {} |
| time | returnTime 为 true 时返回剩余时间 | { seconds } |
方法
组件实例提供 startCountdown() 开始、endCountdown(true) 暂停,endCountdown() 结束并触发 end 事件。更新 value 可重新设置剩余秒数。
插槽
| 插槽 | 说明 |
|---|---|
| — | 官网未列出该组件的插槽 |