vant/src/count-down/README.md

CountDown

Install

import Vue from 'vue';
import { CountDown } from 'vant';

Vue.use(CountDown);

Usage

Basic Usage

<van-count-down :time="time" />

export default {
  data() {
    return {
      time: 30 * 60 * 60 * 1000
    };
  }
}

Custom Format

<van-count-down
  :time="time"
  format="DD Day, HH:mm:ss"
/>

Millisecond

<van-count-down
  millisecond
  :time="time"
  format="HH:mm:ss:SSS"
/>

Custom Style

<van-count-down :time="time">
  <template v-slot="timeData">
    <span class="item">{{ timeData.hours }}</span>
    <span class="item">{{ timeData.minutes }}</span>
    <span class="item">{{ timeData.seconds }}</span>
  </template>
</van-count-down>

<style>
.item {
  display: inline-block;
  width: 22px;
  margin-right: 5px;
  color: #fff;
  font-size: 12px;
  text-align: center;
  background-color: #1989fa;
}
</style>

Manual Control

<van-count-down
  ref="countDown"
  millisecond
  :time="3000"
  :auto-start="false"
  format="ss:SSS"
  @finish="finished"
/>
<van-grid clickable :column-num="3">
  <van-grid-item text="Start" icon="play-circle-o" @click="start" />
  <van-grid-item text="Pause" icon="pause-circle-o" @click="pause" />
  <van-grid-item text="Reset" icon="replay" @click="reset" />
</van-grid>

export default {
  methods: {
    start() {
      this.$refs.countDown.start();
    },
    pause() {
      this.$refs.countDown.pause();
    },
    reset() {
      this.$refs.countDown.reset();
    },
    finish() {
      this.$toast('Finished');
    }
  }
}

API

Props

Attribute	Description	Type	Default	Version
time	Total time	number	-	-
format	Time format，DD-day，HH-hour，mm-minute，ss-second，SSS-millisecond	string	HH:mm:ss	-
auto-start	Whether to auto start count down	boolean	true	-
millisecond	Whether to enable millisecond render	boolean	false	-

Events

Event	Description	Arguments
finish	Triggered when count down finished	-

Slots

Name	Description	SlotProps
default	Custom Content	timeData

timeData Structure

Name	Description	Type
days	Remain days	number
hours	Remain hours	number
minutes	Remain minutes	number
seconds	Remain seconds	number
milliseconds	Remain milliseconds	number

Methods

Use ref to get CountDown instance and call instance methods

Name	Description	Attribute	Return value
start	Start count down	-	-
pause	Pause count down	-	-
reset	Reset count down	-	-