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 | 字体颜色 |