Zepto源码之touch模块

;(function($){
  var touch = {},
    touchTimeout, tapTimeout, swipeTimeout, longTapTimeout,
    longTapDelay = 750,
    gesture,
    down, up, move,
    eventMap,
    initialized = false

  // 滑动方向
  function swipeDirection(x1, x2, y1, y2) {
    // 先判断水平与垂直方向谁的相对位移比较大，如果水平方向大，那就是水平滑动，否则就是垂直滑动
    return Math.abs(x1 - x2) >=
    // 判断完了方向再比较两个手势点位移，通过位移差判断是上下左右滑动
      Math.abs(y1 - y2) ? (x1 - x2 > 0 ? 'Left' : 'Right') : (y1 - y2 > 0 ? 'Up' : 'Down')
  }

  // 长按
  function longTap() {
    // 清空 longTabTimeout 计时器
    longTapTimeout = null
    // 如果 touch.last 存在，则触发 longTap 事件，然后清空 touch 对象，方便下次使用
    if (touch.last) {
      touch.el.trigger('longTap')
      touch = {}
    }
  }

  // 取消长按
  function cancelLongTap() {
    // 清空 longTabTimeout 计时器
    if (longTapTimeout) clearTimeout(longTapTimeout)
    longTapTimeout = null
  }

  // 取消全部
  function cancelAll() {
    // 清空所有计时器，然后清空 touch 对象，方便下次使用
    if (touchTimeout) clearTimeout(touchTimeout)
    if (tapTimeout) clearTimeout(tapTimeout)
    if (swipeTimeout) clearTimeout(swipeTimeout)
    if (longTapTimeout) clearTimeout(longTapTimeout)
    touchTimeout = tapTimeout = swipeTimeout = longTapTimeout = null
    touch = {}
  }

  // 是否为主触点
  function isPrimaryTouch(event){
    // 通过检查事件类型是点击事件且是主触点来判断。只处理手指事件
    return (event.pointerType == 'touch' ||
      event.pointerType == event.MSPOINTER_TYPE_TOUCH)
      && event.isPrimary
  }

  // 是否是点击事件类型
  function isPointerEventType(e, type){
    // 反正在前端上面喷微软就是政治正确就是了，为了微软专门写的浏览器hack
    return (e.type == 'pointer'+type ||
      e.type.toLowerCase() == 'mspointer'+type)
  }

  // 未注册的事件，其实也就是检查一下初始化是否执行过
  function unregisterTouchEvents(){
    if (!initialized) return
    $(document).off(eventMap.down, down)
      .off(eventMap.up, up)
      .off(eventMap.move, move)
      .off(eventMap.cancel, cancelAll)
    $(window).off('scroll', cancelAll)
    cancelAll()
    initialized = false
  }

  // 初始化模块，其实也就是自执行的一种方式 
  function setup(__eventMap){
    var now, delta, deltaX = 0, deltaY = 0, firstTouch, _isPointerType

    unregisterTouchEvents()

    // 根据不同的浏览器，给定不同的事件类型，使用在框架内部得以统一
    eventMap = (__eventMap && ('down' in __eventMap)) ? __eventMap :
      ('ontouchstart' in document ?
      { 'down': 'touchstart', 'up': 'touchend',
        'move': 'touchmove', 'cancel': 'touchcancel' } :
      'onpointerdown' in document ?
      { 'down': 'pointerdown', 'up': 'pointerup',
        'move': 'pointermove', 'cancel': 'pointercancel' } :
       'onmspointerdown' in document ?
      { 'down': 'MSPointerDown', 'up': 'MSPointerUp',
        'move': 'MSPointerMove', 'cancel': 'MSPointerCancel' } : false)

    if (!eventMap) return

    // 日常黑微软，这又是为了处理 IE
    if ('MSGesture' in window) {
      // 创建一个手势对象
      gesture = new MSGesture()
      // 绑定对象
      gesture.target = document.body

      $(document)
        .bind('MSGestureEnd', function(e){
        // 绑定事件，分析在IE下的手势方向，然后触发对应事件
        // 此段代码作用类似于 swipeDirection
          var swipeDirectionFromVelocity =
            e.velocityX > 1 ? 'Right' : e.velocityX < -1 ? 'Left' : e.velocityY > 1 ? 'Down' : e.velocityY < -1 ? 'Up' : null
          if (swipeDirectionFromVelocity) {
            touch.el.trigger('swipe')
            touch.el.trigger('swipe'+ swipeDirectionFromVelocity)
          }
        })
    }

    down = function(e){
      // 只要不是滑动事件，或者不是向下滑动那么直接返回，不执行下面步骤
      if((_isPointerType = isPointerEventType(e, 'down')) &&
        !isPrimaryTouch(e)) return
      // 如果是滑动事件，那么记录第一根手指的信息
      firstTouch = _isPointerType ? e : e.touches[0]
      // 是单指操作的时候，重置终点信息
      if (e.touches && e.touches.length === 1 && touch.x2) {
        touch.x2 = undefined
        touch.y2 = undefined
      }
      // 记录触点信息
      now = Date.now()
      delta = now - (touch.last || now)
      touch.el = $('tagName' in firstTouch.target ?
        firstTouch.target : firstTouch.target.parentNode)
      touchTimeout && clearTimeout(touchTimeout)
      touch.x1 = firstTouch.pageX
      touch.y1 = firstTouch.pageY
      // 检查是不是双击事件
      if (delta > 0 && delta <= 250) touch.isDoubleTap = true
      // 检查是不是长按事件
      touch.last = now
      longTapTimeout = setTimeout(longTap, longTapDelay)
      // 黑IE，单独处理IE
      if (gesture && _isPointerType) gesture.addPointer(e.pointerId)
    }

    move = function(e){
    // 只要不是滑动事件，或者不是 move 事件那么直接返回，不执行下面步骤
      if((_isPointerType = isPointerEventType(e, 'move')) &&
        !isPrimaryTouch(e)) return
      firstTouch = _isPointerType ? e : e.touches[0]
      // 竟然移动了，那肯定不是长按事件，取消长按事件
      cancelLongTap()
      //记录移动终点的信息
      touch.x2 = firstTouch.pageX
      touch.y2 = firstTouch.pageY
      // 计算手指移动起点终点间的位移
      deltaX += Math.abs(touch.x1 - touch.x2)
      deltaY += Math.abs(touch.y1 - touch.y2)
    }

    up = function(e){
    // 只要不是滑动事件，或者不是 up 事件那么直接返回，不执行下面步骤
      if((_isPointerType = isPointerEventType(e, 'up')) &&
        !isPrimaryTouch(e)) return
        // 手指竟然松开了，那肯定不是长按，取消长按
      cancelLongTap()

      // 如果手指间移动超过30,那么就是 swipe滑动事件
      if ((touch.x2 && Math.abs(touch.x1 - touch.x2) > 30) ||
          (touch.y2 && Math.abs(touch.y1 - touch.y2) > 30))
        // 触发对应的滑动事件
        swipeTimeout = setTimeout(function() {
          if (touch.el){
            touch.el.trigger('swipe')
            touch.el.trigger('swipe' + (swipeDirection(touch.x1, touch.x2, touch.y1, touch.y2)))
          }
          touch = {}
        }, 0)

      else if ('last' in touch)
        if (deltaX < 30 && deltaY < 30) {
          // 如果 last 存在，那么不是 swipe 事件。
          tapTimeout = setTimeout(function() {
            var event = $.Event('tap')
            event.cancelTouch = cancelAll
            if (touch.el) touch.el.trigger(event)

            if (touch.isDoubleTap) {
              if (touch.el) touch.el.trigger('doubleTap')
              touch = {}
            }

            else {
              touchTimeout = setTimeout(function(){
                touchTimeout = null
                if (touch.el) touch.el.trigger('singleTap')
                touch = {}
              }, 250)
            }
          }, 0)
        } else {
          touch = {}
        }
        deltaX = deltaY = 0
    }

    $(document).on(eventMap.up, up)
      .on(eventMap.down, down)
      .on(eventMap.move, move)
    $(document).on(eventMap.cancel, cancelAll)
    $(window).on('scroll', cancelAll)

    initialized = true
  }
  // 给对应的事件绑定 callback
  ;['swipe', 'swipeLeft', 'swipeRight', 'swipeUp', 'swipeDown',
    'doubleTap', 'tap', 'singleTap', 'longTap'].forEach(function(eventName){
    $.fn[eventName] = function(callback){ return this.on(eventName, callback) }
  })

  $.touch = { setup: setup }

  $(document).ready(setup)
})(Zepto)