# cCountDown倒计时组件

# 使用教程

点击查看教程

# 使用文档

# 导入

main.js中:

import { cCountDown } from 'cpm-ui'
Vue.use(cCountDown)
1
2

# 调用

<cCountDown :time="5 * 60 * 60 * 1000"></cCountDown>
1

# 属性props

参数 说明 类型 可选值 默认值
time 剩余时间戳(毫秒) Number 0
format 时间格式,DD-日,HH-时,mm-分,ss-秒,SSS-毫秒 String HH:mm:ss
autoStart 是否自定开始倒计时 Boolean truefalse true

# 事件Event

方法 说明
onFinish 倒计时结束回调

如:

<cCountDown :time="5 * 60 * 60 * 1000" @onFinish="onFinish"></cCountDown>
1

如需手动控制倒计时,可手动调用内部的 startpausereset 方法,如:

<cCountDown :time="5000" :autoStart="false" format="ss:SSS" ref="countDown"></cCountDown>
<cButton type="primary" size="smaller" @onClick="startCount">开始</cButton>
<cButton type="primary" size="smaller" @onClick="pauseCount">暂停</cButton>
<cButton type="primary" size="smaller" @onClick="resetCount">重置</cButton>
1
2
3
4
startCount () {
  this.$refs.countDown.start()
},
pauseCount () {
  this.$refs.countDown.pause()
},
resetCount () {
  this.$refs.countDown.reset()
},
1
2
3
4
5
6
7
8
9

# 插槽slot

如需自定义样式,采用slot的方式插入dom,slotProps为自定义的名称,timeData为格式化时间对象(未处理补时长),如:

<cCountDown :time="30 * 60 * 60 * 1000" class="count-down">
  <template v-slot="slotProps">
    <span>{{ slotProps.timeData.h }}</span>
    <span>{{ slotProps.timeData.m }}</span>
    <span>{{ slotProps.timeData.s }}</span>
  </template>
</cCountDown>

<cCountDown :time="30 * 60 * 60 * 1000" class="count-down">
  <template v-slot="slotProps">
    <span>{{ ('0' + slotProps.timeData.h).slice(-2) }}</span>
    <i>:</i>
    <span>{{ ('0' + slotProps.timeData.m).slice(-2) }}</span>
    <i>:</i>
    <span>{{ ('0' + slotProps.timeData.s).slice(-2) }}</span>
  </template>
</cCountDown>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# 特别提示

Last Updated: 12/12/2019, 7:37:32 PM

注:因PC端浏览存在最小12px字号的原因,部分视图下文字会显示比较大,手机端访问正常。