0.3.4 • Published 7 years ago
o3-countdown v0.3.4
o3-countdown - 0.3.x
o3-countdown是一个倒计时组件，具备以下功能
- 在倒计时过程中可以手动停止并执行回调函数，或时间到达自动执行回调函数，
- 倒计时开始时机手动触发
- 对大月、小月做了区分，可满足跨天的特殊场景
- 同时支持y-M-d-h-m-s格式，n（1 <= n <= 6）个相连格式可正确返回相应数据，例如：'y-M-d-h-m-s', 'y-M-d-h-m','M-d-h','m-s'等
- y -- 年
- M -- 月
- d -- 日
- h -- 时
- m -- 分
- s -- 秒
- 返回数据，在格式中选了n个，返回n个数据，数据格式为数组，例如：'M-d-h' => '04', '03', '59'
0.3.x
- 支持了同一页面多个倒计时功能
- 优化代码结构
- 改变调用方式
配置参数
| 配置参数 | 参数类型 | 参数默认值 | 作用说明 |
|---|---|---|---|
| startTime | int | 当前时间「(new Date()).getTime() | 开始时间 |
| stopTime | int | 当前时间「(new Date()).getTime() | 结束时间，如果结束已过，则执行stop回调函数 |
| format | string | 'd-h-m-s' | 最多支持'y-M-d-h-m-s'格式 |
| every | callback | / | 每1000ms执行一次，直至stopTime时间过去 |
| stop | callback | / | 达到stopTime指定时间时，调用 |
方法
| 方法名称 | 入参说明 | 返回值 | 作用说明 |
|---|---|---|---|
| start() | / | countdown自身对象 | 开始倒计时 |
| stop() | / | countdown自身对象 | 结束倒计时 |
用例
var countDown = new CountDown({
startTime: (new Date(2016, 3, 13, 2, 11, 50)).getTime(),
stopTime: (new Date(2018, 3, 15, 2, 13, 0)).getTime(),
format: 'y-M-d',
every: function(data) {
// 间隔1000毫秒执行一次
console.log(data);
},
stop: function(data) {
console.log('stop');
}
}));
// 手动触发开始
countDown.start();
setTimeout(function() {
手动触发停止
countDown.stop(stopId);
}, 2000);0.2.x(原O2-countdown) 和 0.3.x完全不兼容，如果还在使用0.2.x版本，可参考0.2.x版本文档