Menu
小程序资讯
小程序资讯
秀杰实战教程系列《四》:倒计时组件,LXStepper组件-商品数量加减 ...
时间:2016-10-18 16:22:00
一:倒计时组件:适用于电商应用的限时团购、商品秒杀等
先来看下最终效果:


git源:http://git.oschina.net/dotton/CountDown

分步骤-性子急的朋友,可以直接看最后那段代码。

wxml文件放个text

<text>second: {{second}} micro second:{{micro_second}}</text>
在js文件中调用

function countdown(that) {
  var second = that.data.second
  if (second == 0) {
    // console.log("Time Out...");
    that.setData({
      second: "Time Out..."
    });
    return ;
  }
  var time = setTimeout(function(){
    that.setData({
      second: second - 1
    });
    countdown(that);
  }
  ,1000)
}

Page({
    data: {
        second: 3
    },
    onLoad: function() {
        countdown(this);
    }
});
运行验证下,从10走到1s,然后显示时间到。

于是继续将毫秒完善,注意毫秒的步长受限于系统的时间频率,于是我们精确到0.01s即10ms

js

/* 秒级倒计时 */
function countdown(that) {
  var second = that.data.second
  if (second == 0) {
    that.setData({
      second: "Time out!",
      micro_second: "micro_second too."
    });
    clearTimeout(micro_timer);
    return ;
  }
  var timer = setTimeout(function(){
    that.setData({
      second: second - 1
    });
    countdown(that);
  }
  ,1000)
}

/* 毫秒级倒计时 */
// 初始毫秒数,同时用作归零
var micro_second_init = 100;
// 当前毫秒数
var micro_second_current = micro_second_init;
// 毫秒计时器
var micro_timer;

function countdown4micro(that) {
  if (micro_second_current <= 0) {
    micro_second_current = micro_second_init;
  }
  micro_timer = setTimeout(function(){
    that.setData({
      micro_second: micro_second_current - 1
    });
    micro_second_current--;
    countdown4micro(that);
  }
  ,10)
}

Page({
    data: {
        second: 2,
        micro_second: micro_second_init
    },
    onLoad: function() {
        countdown(this);
        countdown4micro(this);
    }
});
wxml文件

<text style="display: block;">second: {{second}}s</text>

<text>{{micro_second}}</text>
如此,当秒级运行完毕时,毫秒级timer即clearTimeout,并将字本显示为'micro_second too'

再添加一个countdown4micro方法,使得显示剩余 0:3:19 89这样形式的倒数

function dateformat(second) {
    var dateStr = "";
    var hr = Math.floor(second / 3600);
    var min = Math.floor((second - hr * 3600) / 60);
    var sec = (second - hr * 3600 - min * 60);// equal to => var sec = second % 60;
    dateStr = hr + ":" + min + ":" + sec;
    return dateStr;
}
目前有2个时钟,影响性能,合并下去掉countdown,于是countdown4micro变成以下的样子:

function countdown4micro(that) {

    var loop_second = Math.floor(loop_index / 100);
    // 得知经历了1s
    if (cost_micro_second != loop_second) {
        // 赋予新值
        cost_micro_second = loop_second;
        // 总秒数减1
        total_second--;

    }
      // 每隔一秒,显示值减1; 渲染倒计时时钟
    that.setData({
      clock:dateformat(total_second - 1)
    });

      if (total_second == 0) {
        that.setData({
          // micro_second: "",
          clock:"时间到"
        });
        clearTimeout(micro_timer);
        return ;
      }    

  if (micro_second_current <= 0) {
    micro_second_current = micro_second_init;
  }
  micro_timer = setTimeout(function(){
    that.setData({
      micro_second: micro_second_current - 1
    });
    micro_second_current--;
    // 放在最后++,不然时钟停止时还有10毫秒剩余
    loop_index ++;
    countdown4micro(that);
  }
  ,10)
}
如此这般,毫秒与时分秒是分别运行渲染的,再次改造,程序可读性更好。dateformat针对于毫秒操作,而不接受秒为数。同时还省却了计算100次为1s的运算

/** 
 * 需要一个目标日期,初始化时,先得出到当前时间还有剩余多少秒
 * 1.将秒数换成格式化输出为XX天XX小时XX分钟XX秒 XX
 * 2.提供一个时钟,每10ms运行一次,渲染时钟,再总ms数自减10
 * 3.剩余的秒次为零时,return,给出tips提示说,已经截止
 */

// 定义一个总毫秒数,以一分钟为例。TODO,传入一个时间点,转换成总毫秒数
var total_micro_second = 2 * 1000;

/* 毫秒级倒计时 */
function countdown(that) {
      // 渲染倒计时时钟
      that.setData({
          clock:dateformat(total_micro_second)
      });

      if (total_micro_second <= 0) {
          that.setData({
              clock:"已经截止"
          });
          // timeout则跳出递归
          return ;
      }    
      setTimeout(function(){
        // 放在最后--
        total_micro_second -= 10;
        countdown(that);
    }
    ,10)
}

// 时间格式化输出,如3:25:19 86。每10ms都会调用一次
function dateformat(micro_second) {
      // 秒数
      var second = Math.floor(micro_second / 1000);
      // 小时位
      var hr = Math.floor(second / 3600);
      // 分钟位
      var min = Math.floor((second - hr * 3600) / 60);
      // 秒位
    var sec = (second - hr * 3600 - min * 60);// equal to => var sec = second % 60;
    // 毫秒位,保留2位
    var micro_sec = Math.floor((micro_second % 1000) / 10);
    return hr + ":" + min + ":" + sec + " " + micro_sec;
}

Page({
    data: {
        clock: ''
    },
    onLoad: function() {
        countdown(this);
    }
});
经过如上优化,代码量减少一半,运行效率也高了。

二:LXStepper组件-商品数量加减:适用于购物车商品数量的加减

翻看了个文档,微信没有提供现成的组件,于是写了这个小widget。


总体思路:

最左边框,最右边框由最后外层的容器的border-left与border-right设定;中间2段由input来设定;左右按钮不设边框,圆角效果由最外面容器来设定,这样刚好实现了一个耳熟能详的stepper样式。

布局:
1.1 准备一个容器view,设置它的宽为width: 70px;height: 21px;边框颜色为#ccc灰色;圆角3px;

1.2 内置3个组件,分别是左text,中input,右text,之所以不用button是因为系统自带的button带了样式,为了遵守设计规范,不去重写button的样式。其中input的默认高度是21px。宽度分别为19px,30px,19px,之所以是19px,是因为容器带了左右边距,共占据了2px。

1.3 3个组件都是文字居中,text-align: center实现;垂直居中使用line-height: 21px来实现

1.4 3个组件都是向左浮动,由于我们计算好3个组件的宽度绝对值,于是不必设定加号按钮的浮动float: right


布局文件代码

<!-- Stepper容器 -->
<view class="stepper">
    <!-- 减号 -->
    <text>-</text>
    <!-- 数值 -->
    <input type="number" value="{{num}}" />
    <!-- 加号 -->
    <text>+</text>
</view>
样式表代码

/*stepper容器*/
.stepper {
    border: 1px solid #ccc;
    border-radius: 3px;
    width: 70px;
    height: 21px;
    margin:0 auto;
}


/*加号与减号*/
.stepper text {
    width: 19px;
    height: 28px;
    line-height: 21px;
    text-align: center;
    float: left;
}


/*数值*/
.stepper input {
    float: left;
    margin: 0 auto;
    width: 30px;
    text-align: center;
    font-size: 12px;
    border-left: 1px solid #ccc;
    border-right: 1px solid #ccc;
}
绑定事件
2.1 准备两个按钮样式分别对应普通与禁用状态

/*普通样式*/
.stepper .normal{
    color: black;
}

/*禁用样式*/
.stepper .disabled{
    color: #ccc;
}
还要准备一个data的值对象,用于监测数值与状态的改变:

data: {
    num: 1,
    minusStatus: 'disabled'
}
2.2 加号与减号事件

2.2.1 绑定text事件bindtap,分别是bindMinus,bindPlus。按如下处理:取出data中的num值后作自增与自减,对于自减操作要先判断是否大于1才做自减操作,也就是说已经是1的时候,就不要自减了

2.2.2 当num已经为1的时候,我们将减号按钮设置为disabled样式,一旦大于1,又变回normal状态,加减事件均要如此处理,不然到了临界值1的时候,回不到normal状态

js代码:

bindMinus: function() {
    var num = this.data.num;
    // 如果只有1件了,就不允许再减了
    if (num > 1) {
        num --;
    }
    // 只有大于一件的时候,才能normal状态,否则disable状态
    var minusStatus = num <= 1 ? 'disabled' : 'normal';
    // 将数值与状态写回
    this.setData({
        num: num,
        minusStatus: minusStatus
    });
},
效果如图,注意减号是灰色的#ccc


2.3 文本框输入事件

2.3.1 在wxml文件中的\<input\>监听值变更事件bindchange="bindManual"。注:bindchange是失去焦点才会调用一次的,而bininput是每当有值有改变会有调用一次,敲打123,则会产生值1,12,123三次,比较适合于输入验证。

2.3.2 实现bindManual

bindManual: function(e) {
    var num = e.detail.value;
    // 将数值与状态写回
    this.setData({
        num: num
    });
}
这个步骤看似多余,实则为了num个数同步,以作为提交到网络数据时是真正的data.num,而不是input手工改写的数值