Skip to content

schinvendy/taro-countdown

Repository files navigation

安装及使用

在项目中安装:

npm i -S taro-countdown
import Countdown from 'taro-countdown';

<Countdown targetTime="2018-12-22" />;
<Countdown count={60} />

预览

taro-countdown

功能

倒计时分为时间倒计时秒数倒计时

设置 targetTime 为 时间倒计时模式

设置 count 为 秒数倒计时模式

只要设置了 targetTime,则显示为时间倒计时模式

基础使用

<Countdown targetTime={this.state.targetTime} />
<Countdown targetTime="2019-12-30 20:00:00" />
<Countdown count={60} />

异步赋值

3 秒后赋值,再 3 秒后设置目标时间为:2019-12-31 23:30:30

setTimeout(() => {
  this.setState(
    {
      time1: '2019-12-30 20:00:00',
    },
    () => {
      setTimeout(() => {
        this.setState({
          time1: '2019-12-31 23:30:30',
        });
      }, 3000);
    },
  );
}, 3000);
<Countdown targetTime={time1} />

修改间隔符号

<Countdown targetTime={time1} symbol="--" />

修改字体颜色

<Countdown targetTime={time1} color="#2196F3" />

自定义样式

.demo-class {
  padding: 8px 20px;
  background: linear-gradient(to top right, #ff6355, #fe4737);
  color: #fff !important;
  border: 1px solid #fe4737;
  border-radius: 100px;
  font-family: Arial, Helvetica, sans-serif;
  .symbol,
  .day-text {
    margin: 0 8px;
  }
}
<Countdown className="demo-class" targetTime={targetTime} />

显示天数、时分秒

<Countdown className="demo-class" showDay targetTime={targetTime} />

<Countdown className="demo-class" showText targetTime={targetTime} />

<Countdown className="demo-class" showDay showText targetTime={targetTime} symbol="/" />

倒计时过程事件

onTimeTick = second => {
  this.setState({ second });
};
<View className="m-b-2">剩余秒数:{this.state.second}</View>

<Countdown targetTime={targetTime} showText showDay color="#2196F3" onTick={this.onTimeTick.bind(this)} />

手动结束事件

onCloseCountdown = state => {
  this.setState({
    isClose: state,
  });
};

onTimeEnd = () => {
  Taro.showToast({
    title: '倒计时结束',
  });
  console.log('倒计时结束触发事件');
};
<Button size="mini" type="default" onClick={this.onCloseCountdown.bind(this, true)}>结束倒计时</Button>

<Countdown targetTime={targetTime} isClose={this.state.isClose} onEnd={this.onTimeEnd.bind(this)} />

参数

参数 说明 类型 可选值 默认值
targetTime 目标时间 String - -
count 倒计秒数 Number - -
color 字体颜色 String - inherit
以下为 targetTime 模式生效
symbol 间隔符号 String -
showDay 是否显示天 Boolean - false
showText 是否显示时分秒 Boolean - false
isClose 是否关闭倒计时 Boolean - false

事件

事件名称 说明 返回参数
onTick 倒计时过程事件 剩余的秒数
onEnd 倒计时结束时触发 -

该项目的打包命令

TARO_BUILD_TYPE=ui taro build --ui

在 windows 环境下打包的 H5 文件可能不正确,可以尝试

在 cmd 中:

先输入

set TARO_BUILD_TYPE=ui

再输入

taro build --ui

在 PowerShell 中:

先输入

$env:TARO_BUILD_TYPE=“ui“

再输入

taro build --ui

Releases

No releases published

Packages

No packages published