Skip to content

Countdown 倒计时


倒计时组件

使用指南

在 Taro 文件中引入组件

js
import { AtCountdown } from 'taro-ui'

组件依赖的样式文件(仅按需引用时需要)

scss
@import "~taro-ui/dist/style/components/countdown.scss";

一般用法

说明: 开发者可以设置 onTimeUp 倒计时时间到回调事件

js
import Taro from '@tarojs/taro'
import { View } from '@tarojs/components'
import { AtCountdown } from 'taro-ui'

export default class CountdownPage extends Taro.Component {
  onTimeUp () {
    Taro.showToast({
      title: '时间到',
      icon: 'success',
      duration: 2000
    })
  }
  render () {
    return (
      <AtCountdown
        format={{ hours: ':', minutes: ':', seconds: '' }}
        seconds={10}
        onTimeUp={this.onTimeUp.bind(this)}
      />
    )
  }
}

显示天数

html
<AtCountdown
  isShowDay
  day={2}
  hours={1}
  minutes={1}
  seconds={10}
/>

只显示秒钟

html
<AtCountdown
  isShowHour={false}
  isShowMinute={false}
  seconds={90}
/>

自定义格式化

html
<AtCountdown
  format={{ hours: ':', minutes: ':', seconds: '' }}
  day={2}
  hours={1}
  minutes={1}
  seconds={10}
/>

卡片式

html
<AtCountdown
  isCard
  minutes={1}
  seconds={10}
/>

参数

参数说明类型可选值默认值
isCard是否显示卡片式样式Boolean-false
isShowDay是否显示天数Boolean-false
isShowHour是否显示小时Boolean-true
isShowMinute是否显示分钟Boolean-true
format格式化分割符号Object-day: '天',hours: '时',minutes: '分',seconds: '秒'
day天数Number-0
hours小时Number-0
minutes分钟Number-0
secondsNumber-0

事件

事件名称说明返回参数
onTimeUp倒计时时间到,执行的回调函数-

Released under the MIT License.