BUI

其它版本:

API for BUI 1.6.x

Show:

bui.timer Class

Module: UI

计时器,可以递减或者递增, 可以用来做秒杀, 1.5.6新增,支持不同类型设定times 预览地址: demo

Constructor

bui.timer

(
  • option
)
Object

Parameters:

  • option Object
    • target String

      [时间显示在某个id 上]

    • onEnd Function

      [时间到以后执行回调]

    • [onProcess] [过程处理函数,参数为当前秒数] Function optional
    • [type] [1.5.6新增, 定义times的类型, 默认 number(跟second类似,输出是大于60的数字) | second | minute | hour | date | day] String optional
    • [time] [1.5.6新增, 默认:10秒 当 type=minute 10等于10分钟 依次类推, 当type] Number optional
    • [times] [ 废弃] Number optional
    • [fixZero] [1.5.6新增, 小余10是否在前面补零, 默认 true | false] Number optional
    • [reduce] [默认:true 递减 | false 递增] Boolean optional

Returns:

Object:

[ start 开始计时 | stop 停止计时 | pause 暂停 | restart 重新计时 ]

Example:

   // 例子1: 倒计时10秒
                                   html: 
                                   <div id="time"></div>
                                   
                                   js: 
                                   var timer = bui.timer({
                                       target: "#time",
                                       onEnd: function (argument) {
                                           bui.alert("时间到")
                                       },
                                       type: "number",
                                       time: 10
                                   })
                                
                                   timer.start();
                                
                                   // 例子2: 倒计时10分钟
                                   js: 
                                   var timer = bui.timer({
                                       target: "#time",
                                       onEnd: function (argument) {
                                           bui.alert("时间到")
                                       },
                                       type: "minute",
                                       time: 10
                                   })
                                
                                   timer.start();
                                
                                   // 例子3:倒计时1天
                                   js: 
                                   var timer = bui.timer({
                                       target: "#time",
                                       onEnd: function (argument) {
                                           bui.alert("时间到")
                                       },
                                       type: "minute",
                                       time: 10
                                   })
                                
                                   timer.start();
                                
                                   // 例子4: 离今晚12点还有多少时间
                                   var afterDate = bui.date.after(new Date(), 1);
                                   time = bui.timer({
                                       target: "#time",
                                       onEnd: function (argument) {
                                           bui.alert("时间到")
                                       },
                                       type: "date",
                                       time: afterDate
                                   });
                                   time.start();
                                

Item Index

Methods

pause

()

暂停

Example:

       timer.pause();
                                            

restart

()

重新计时

Example:

       timer.restart();
                                            

start

()

开始计时,递减或者递增取决于初始化的reduce是否为true

Example:

       timer.start();
                                            

status

()

是否在计时中

Example:

       // true 正在进行倒计时
                                                   var status = timer.status();
                                            

stop

()

停止计时

Example:

       timer.stop();