Show:

bui.timer Class

Module: UI

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

Constructor

bui.timer

(
  • option
)

Parameters:

  • option Object
    • target String

      时间显示在某个id 上

    • [uid] String optional

      1.6.6新增,自定义控件的唯一id,非必须

    • onEnd Function

      时间到以后执行回调

    • [onProcess] Function optional

      过程处理函数,参数为当前秒数

    • [type] String optional

      1.5.6新增, 定义times的类型, 默认 number(跟second类似,输出是大于60的数字) | second | minute | hour | date | day

    • [time] Number optional

      1.5.6新增, 默认:10秒 当 type=minute 10等于10分钟 依次类推, 当type="date" 时, time 传某个日期 "2020-3-20 10:00"

    • [times] Number optional

      废弃

    • [fixZero] Number optional

      1.5.6新增, 小余10是否在前面补零, 默认 true | false

    • [reduce] Boolean optional

      默认:true 递减 | false 递增

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();