如何實現swipe、tap、longTap等自定義事件

謙龍發表於2018-03-03

前言

移動端原生支援touchstarttouchmovetouchend等事件,但是在平常業務中我們經常需要使用swipetapdoubleTaplongTap等事件去實現想要的效果,對於這種自定義事件他們底層是如何實現的呢?讓我們從Zepto.jstouch模組去分析其原理。您也可以直接檢視touch.js原始碼註釋

原始碼倉庫

原文連結

touch

事件簡述

Zepto的touch模組實現了很多與手勢相關的自定義事件,分別是swipe, swipeLeft, swipeRight, swipeUp, swipeDown,doubleTap, tap, singleTap, longTap

事件名稱 事件描述
swipe 滑動事件
swipeLeft ←左滑事件
swipeRight →右滑事件
swipeUp ↑上滑事件
swipeDown ↓下滑事件
doubleTap 雙擊事件
tap 點選事件(非原生click事件)
singleTap 單擊事件
longTap 長按事件
;['swipe', 'swipeLeft', 'swipeRight', 'swipeUp', 'swipeDown', 'doubleTap', 'tap', 'singleTap', 'longTap'].forEach(function(eventName){
  $.fn[eventName] = function(callback){ return this.on(eventName, callback) }
})

複製程式碼

可以看到Zepto把這些方法都掛載到了原型上,這意味著,你可以直接用簡寫的方式例如$('body').tap(callback)

前置條件

在開始分析這些事件如何實現之前,我們先了解一些前置條件

  • 部分內部變數
var touch = {},
    touchTimeout, tapTimeout, swipeTimeout, longTapTimeout,
    // 長按事件定時器時間
    longTapDelay = 750,
    gesture

複製程式碼

touch: 用以儲存手指操作的相關資訊,例如手指按下時的位置,離開時的座標等。

touchTimeout,tapTimeout, swipeTimeout,longTapTimeout分別儲存singleTap、tap、swipe、longTap事件的定時器。

longTapDelay:longTap事件定時器延時時間

gesture: 儲存ieGesture事件物件

  • 滑動方向判斷(swipeDirection)

我們根據下圖以及對應的程式碼來理解滑動的時候方向是如何判定的。需要注意的是瀏覽器中的“座標系”和數學中的座標系還是不太一樣,Y軸有點反過來的意思。

手機螢幕座標圖

/**
  * 判斷移動的方向,結果是Left, Right, Up, Down中的一個
  * @param  {} x1 起點的橫座標
  * @param  {} x2 終點的橫座標
  * @param  {} y1 起點的縱座標
  * @param  {} y2 終點的縱座標
  */

function swipeDirection(x1, x2, y1, y2) {
  /**
    * 1. 第一個三元運算子得到如果x軸滑動的距離比y軸大,那麼是左右滑動,否則是上下滑動
    * 2. 如果是左右滑動,起點比終點大那麼往左滑動
    * 3. 如果是上下滑動,起點比終點大那麼往上滑動
    * 需要注意的是這裡的座標和數學中的有些不一定 縱座標有點反過來的意思
    * 起點p1(1, 0) 終點p2(1, 1)
    */
  return Math.abs(x1 - x2) >=
    Math.abs(y1 - y2) ? (x1 - x2 > 0 ? 'Left' : 'Right') : (y1 - y2 > 0 ? 'Up' : 'Down')
}

複製程式碼
  • 觸發長按事件
function longTap() {
  longTapTimeout = null
  if (touch.last) {
    // 觸發el元素的longTap事件
    touch.el.trigger('longTap')
    touch = {}
  }
}

複製程式碼

在觸發長按事件之前先將longTapTimeout定時器取消,如果touch.last還存在則觸發之,為什麼要判斷touch.last呢,因為swip, doubleTap,singleTap會將touch物件置空,當這些事件發生的時候,自然不應該發生長按事件。

  • 取消長按,以及取消所有事件
// 取消長按
function cancelLongTap() {
  if (longTapTimeout) clearTimeout(longTapTimeout)
  longTapTimeout = null
}

// 取消所有事件

function cancelAll() {
  if (touchTimeout) clearTimeout(touchTimeout)
  if (tapTimeout) clearTimeout(tapTimeout)
  if (swipeTimeout) clearTimeout(swipeTimeout)
  if (longTapTimeout) clearTimeout(longTapTimeout)
  touchTimeout = tapTimeout = swipeTimeout = longTapTimeout = null
  touch = {}
}
複製程式碼

方式都是類似,先呼叫clearTimeout取消定時器,然後釋放對應的變數,等候垃圾回收。

整體結構分析



$(document).ready(function(){
  /**
    * now 當前觸控時間
    * delta 兩次觸控的時間差
    * deltaX x軸變化量
    * deltaY Y軸變化量
    * firstTouch 觸控點相關資訊
    * _isPointerType 是否是pointerType
    */
  var now, delta, deltaX = 0, deltaY = 0, firstTouch, _isPointerType

  $(document)
    .bind('MSGestureEnd', function(e){
      // xxx 先不看這裡
    })
    .on('touchstart MSPointerDown pointerdown', function(e){
      // xxx 關注這裡
    })
    .on('touchmove MSPointerMove pointermove', function(e){
      // xxx 關注這裡
    })
    .on('touchend MSPointerUp pointerup', function(e){
      // xxx 關注這裡
    })
    .on('touchcancel MSPointerCancel pointercancel', cancelAll)

    $(window).on('scroll', cancelAll)
  })


複製程式碼

這裡將詳細程式碼暫時省略了,留出整體框架,可以看出Zepto在dom,ready的時候在document上新增了MSGestureEnd,touchstart MSPointerDown pointerdown,touchmove MSPointerMove pointermove,touchcancel MSPointerCancel pointercancel等事件,最後還給在window上加了scroll事件。我們將目光聚焦在touchstart,touchmove,touchend對應的邏輯,其他相對少見的事件在暫不討論

touchstart

if((_isPointerType = isPointerEventType(e, 'down')) 
&& !isPrimaryTouch(e)) return

複製程式碼

要走到touchstart事件處理程式後續邏輯中,需要先滿足一些條件。到底是哪些條件呢?先來看看isPointerEventType, isPrimaryTouch兩個函式做了些什麼。

**isPointerEventType

function isPointerEventType(e, type){
  return (e.type == 'pointer'+type ||
    e.type.toLowerCase() == 'mspointer'+type)
}

複製程式碼

Pointer Event相關知識點選這裡

isPrimaryTouch

function isPrimaryTouch(event){
  return (event.pointerType == 'touch' ||
    event.pointerType == event.MSPOINTER_TYPE_TOUCH)
    && event.isPrimary
}

複製程式碼

根據mdn pointerType,其型別可以是mouse,pen,touch,這裡只處理其值為touch並且isPrimary為true的情況。

接著回到

if((_isPointerType = isPointerEventType(e, 'down')) 
&& !isPrimaryTouch(e)) return

複製程式碼

其實就是過濾掉非觸控事件。

觸控點資訊相容處理

// 如果是pointerdown事件則firstTouch儲存為e,否則是e.touches第一個
firstTouch = _isPointerType ? e : e.touches[0]

複製程式碼

這裡只清楚e.touches[0]的處理邏輯,另一種不太明白,望有知曉的同學告知一下,感謝感謝。

復原終點座標

// 一般情況下,在touchend或者cancel的時候,會將其清除,如果使用者調阻止了預設事件,則有可能清空不了,但是為什麼要將終點座標清除呢?
if (e.touches && e.touches.length === 1 && touch.x2) {
  // Clear out touch movement data if we have it sticking around
  // This can occur if touchcancel doesn't fire due to preventDefault, etc.
  touch.x2 = undefined
  touch.y2 = undefined
}

複製程式碼

儲存觸控點部分資訊

// 儲存當前時間
now = Date.now()
// 儲存兩次點選時候的時間間隔,主要用作雙擊事件
delta = now - (touch.last || now)
// touch.el 儲存目標節點
// 不是標籤節點則使用該節點的父節點,注意有偽元素
touch.el = $('tagName' in firstTouch.target ?
  firstTouch.target : firstTouch.target.parentNode)
// touchTimeout 存在則清除之,可以避免重複觸發
touchTimeout && clearTimeout(touchTimeout)
// 記錄起始點座標(x1, y1)(x軸,y軸)
touch.x1 = firstTouch.pageX
touch.y1 = firstTouch.pageY

複製程式碼

判斷雙擊事件

// 兩次點選的時間間隔 > 0 且 < 250 毫秒,則當做doubleTap事件處理
if (delta > 0 && delta <= 250) touch.isDoubleTap = true

複製程式碼

處理長按事件

// 將now設定為touch.last,方便上面可以計算兩次點選的時間差
touch.last = now
// longTapDelay(750毫秒)後觸發長按事件
longTapTimeout = setTimeout(longTap, longTapDelay)

複製程式碼

touchmove

.on('touchmove MSPointerMove pointermove', function(e){
  if((_isPointerType = isPointerEventType(e, 'move')) &&
    !isPrimaryTouch(e)) return
  firstTouch = _isPointerType ? e : e.touches[0]
  // 取消長按事件,都移動了,當然不是長按了
  cancelLongTap()
  // 終點座標 (x2, y2)
  touch.x2 = firstTouch.pageX
  touch.y2 = firstTouch.pageY
  // 分別記錄X軸和Y軸的變化量
  deltaX += Math.abs(touch.x1 - touch.x2)
  deltaY += Math.abs(touch.y1 - touch.y2)
})

複製程式碼

手指移動的時候,做了三件事情。

  1. 取消長按事件
  2. 記錄終點座標
  3. 記錄x軸和y軸的移動變化量

touchend

.on('touchend MSPointerUp pointerup', function(e){
  if((_isPointerType = isPointerEventType(e, 'up')) &&
    !isPrimaryTouch(e)) return
  // 取消長按事件  
  cancelLongTap()
  // 滑動事件,只要X軸或者Y軸的起始點和終點的距離超過30則認為是滑動,並觸發滑動(swip)事件,
  // 緊接著馬上觸發對應方向的swip事件(swipLeft, swipRight, swipUp, swipDown)
  // 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)
  // touch物件的last屬性,在touchstart事件中新增,所以觸發了start事件便會存在  
  // normal tap
  else if ('last' in touch)
    // don't fire tap when delta position changed by more than 30 pixels,
    // for instance when moving to a point and back to origin
    // 只有當X軸和Y軸的變化量都小於30的時候,才認為有可能觸發tap事件
    if (deltaX < 30 && deltaY < 30) {
      // delay by one tick so we can cancel the 'tap' event if 'scroll' fires
      // ('tap' fires before 'scroll')
      tapTimeout = setTimeout(function() {

        // trigger universal 'tap' with the option to cancelTouch()
        // (cancelTouch cancels processing of single vs double taps for faster 'tap' response)
        // 建立自定義事件
        var event = $.Event('tap')
        // 往自定義事件中新增cancelTouch回撥函式,這樣使用者可以通過該方法取消所有的事件
        event.cancelTouch = cancelAll
        // [by paper] fix -> "TypeError: 'undefined' is not an object (evaluating 'touch.el.trigger'), when double tap
        // 當目標元素存在,觸發tap自定義事件
        if (touch.el) touch.el.trigger(event)

        // trigger double tap immediately
        // 如果是doubleTap事件,則觸發之,並清除touch
        if (touch.isDoubleTap) {
          if (touch.el) touch.el.trigger('doubleTap')
          touch = {}
        }

        // trigger single tap after 250ms of inactivity
        // 否則在250毫秒之後。觸發單擊事件
        else {
          touchTimeout = setTimeout(function(){
            touchTimeout = null
            if (touch.el) touch.el.trigger('singleTap')
            touch = {}
          }, 250)
        }
      }, 0)
    } else {
      // 不是tap相關的事件
      touch = {}
    }
    // 最後將變化量資訊清空
    deltaX = deltaY = 0

})

複製程式碼

touchend事件觸發時,相應的註釋都在上面了,但是我們來分解一下這段程式碼。

swip事件相關

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)

複製程式碼

手指離開後,通過判斷x軸或者y軸的位移,只要其中一個跨度大於30便會觸發swip及其對應方向的事件。

tap,doubleTap,singleTap

這三個事件可能觸發的前提條件是touch物件中還存在last屬性,從touchstart事件處理程式中知道last在其中記錄,而在touchend之前被清除的時機是長按事件被觸發longTap,取消所有事件被呼叫cancelAll

if (deltaX < 30 && deltaY < 30) {
  // delay by one tick so we can cancel the 'tap' event if 'scroll' fires
  // ('tap' fires before 'scroll')
  tapTimeout = setTimeout(function() {

    // trigger universal 'tap' with the option to cancelTouch()
    // (cancelTouch cancels processing of single vs double taps for faster 'tap' response)
    var event = $.Event('tap')
    event.cancelTouch = cancelAll
    // [by paper] fix -> "TypeError: 'undefined' is not an object (evaluating 'touch.el.trigger'), when double tap
    if (touch.el) touch.el.trigger(event)
  }    
}
複製程式碼

只有當x軸和y軸的變化量都小於30的時候才會觸發tap事件,注意在觸發tap事件之前,Zepto還將往事件物件上新增了cancelTouch屬性,對應的也就是cancelAll方法,即你可以通過他取消所有的touch相關事件。


// trigger double tap immediately

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

// trigger single tap after 250ms of inactivity

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


複製程式碼

在發生觸發tap事件之後,如果是doubleTap,則會緊接著觸發doubleTap事件,否則250毫秒之後觸發singleTap事件,並且都會講touch物件置為空物件,以便下次使用

// 最後將變化量資訊清空
deltaX = deltaY = 0

複製程式碼

touchcancel


.on('touchcancel MSPointerCancel pointercancel', cancelAll)

複製程式碼

touchcancel被觸發的時候,取消所有的事件。

scroll


$(window).on('scroll', cancelAll)

複製程式碼

當滾動事件被觸發的時候,取消所有的事件(這裡有些不解,滾動事件觸發,完全有可能是要觸發tap或者swip等事件啊)。

結尾

最後說一個面試中經常會問的問題,touch擊穿現象。如果對此有興趣可以檢視移動端click延遲及zepto的穿透現象, 新年第一發--深入不淺出zepto的Tap擊穿問題

參考

  1. 移動端click延遲及zepto的穿透現象

  2. 新年第一發--深入不淺出zepto的Tap擊穿問題

  3. 讀Zepto原始碼之Touch模組

  4. pointerType

  5. [翻譯]整合滑鼠、觸控 和觸控筆事件的Html5 Pointer Event Api

文章目錄

相關文章