Count Down 倒计时
用于实时展示倒计时数值,并且支持毫秒级渲染
基本使用
time 属性表示倒计时总时长,单位为毫秒。
00 : 00 : 00: 10
开启
自定义格式
可以使用 format 属性设置倒计时文本的内容。
其中DD代表天 HH代表小时 mm代表分钟 ss代表秒 SSS代表毫秒(开启毫秒级渲染才可以)
02 天 00 小时 00 分钟 00 秒
开启
毫秒级别渲染
millisecond 属性可以开启毫秒级渲染。当为 false 时,渲染间隔为 1s
02 天 00 小时 00 分钟 00 秒 000 毫秒
开启
自定义样式
通过插槽获取实时剩余时间,currentTime格式
0:0:0
开启
Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
time | 倒计时时长,单位毫秒 | string / number | —— | —— |
interval | 倒计时渲染间隔,单位毫秒(开启millisecond则此项无效) | number | —— | 1000 |
format | 时间格式 | string | —— | HH:mm:ss |
auto-start | 是否自动开始倒计时 | boolean | —— | true |
millisecond | 是否开始毫秒级渲染 | boolean | —— | false |
on-finish | 倒计时结束后触发的回调 | CountDownFinish | —— | —— |
Methods
| 参数 | 说明 | 参数 |
|---|---|---|
start | 开始倒计时 | —— |
pause | 暂停倒计时 | —— |
on-reset | 重设倒计时,若 autostart 为 true,重设后会自动开始倒计时 | total-time 倒计时长 |
Slots
| 名称 | 说明 | 参数 |
|---|---|---|
default | 自定义内容 | currentTime:CurrentTime |
Interface
组件导出以下类型定义:
ts
import type { CountDownInstance, CountDownProps, CountDownFinish } from 'fighting-design'CountDownFinish
ts
type CountDownFinish = () => void样式变量
组件提供了下列 CSS 变量,可用于自定义样式。
| 名称 | 描述 |
|---|---|
| --count-down-font-size | 字体大小 |
| --count-down-font-color | 字体颜色 |