萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

為 jQuery 擴展 WebKit 觸摸事件:tap、swipe、長按、捏合縮放完整實現

設計目標

  • 統一桌面(鼠標)與移動端(觸摸)事件模型。
  • 消除移動端 300ms 點擊延遲(tap 替代 click)。
  • 提供高級手勢:swipe、longPress、pinch。

核心實現代碼

;(function($) {
  window.indream = window.indream || {};
  $.indream = indream;

  indream.touch = {
    eventList: {
      // 基礎觸摸事件(直接綁定原生)
      touchStart: { nativeEvent: 'touchstart' },
      touchMove:  { nativeEvent: 'touchmove' },
      touchEnd:   { nativeEvent: 'touchend' },
      
      // 合成事件:tap = touchEnd 無移動 + 無長按
      tap: {
        handler: function(callback) {
          return this.each(function() {
            var $el = $(this);
            var moved = false;
            var timer;
            
            $el.on('touchstart', function(e) {
              moved = false;
              timer = setTimeout(function() {
                // 長按判定
                $el.trigger('longPress', e);
              }, 750);
            });
            
            $el.on('touchmove', function(e) {
              moved = true;
              clearTimeout(timer);
            });
            
            $el.on('touchend', function(e) {
              clearTimeout(timer);
              if (!moved) {
                // 觸發 tap,並阻止後續 click
                $el.trigger('tap', e);
                // 標記已處理,click 時跳過
                $el.data('tapHandled', true);
                setTimeout(function() { $el.removeData('tapHandled'); }, 0);
              }
            });
            
            // 兼容桌面 click
            $el.on('click', function(e) {
              if (!$el.data('tapHandled')) callback.call(this, e);
            });
          });
        }
      },
      
      // 滑動手勢
      swipe: {
        handler: function(callback) {
          return this.each(function() {
            var $el = $(this);
            var startX, startY, startTime;
            
            $el.on('touchstart', function(e) {
              var touch = e.originalEvent.touches[0];
              startX = touch.pageX;
              startY = touch.pageY;
              startTime = Date.now();
            });
            
            $el.on('touchend', function(e) {
              var touch = e.originalEvent.changedTouches[0];
              var dx = touch.pageX - startX;
              var dy = touch.pageY - startY;
              var dt = Date.now() - startTime;
              
              if (dt < 300 && Math.abs(dx) > 30) {
                var dir = dx > 0 ? 'right' : 'left';
                $el.trigger('swipe', { direction: dir, distance: Math.abs(dx), duration: dt });
                callback.call(this, dir, dx, dy, dt);
              } else if (dt < 300 && Math.abs(dy) > 30) {
                var dir = dy > 0 ? 'down' : 'up';
                $el.trigger('swipe', { direction: dir, distance: Math.abs(dy), duration: dt });
                callback.call(this, dir, dx, dy, dt);
              }
            });
          });
        }
      },
      
      // 捏合縮放(雙指)
      pinch: {
        handler: function(callback) {
          return this.each(function() {
            var $el = $(this);
            var initialDist;
            
            $el.on('touchstart', function(e) {
              if (e.originalEvent.touches.length === 2) {
                var t1 = e.originalEvent.touches[0];
                var t2 = e.originalEvent.touches[1];
                initialDist = Math.hypot(t1.pageX - t2.pageX, t1.pageY - t2.pageY);
              }
            });
            
            $el.on('touchmove', function(e) {
              if (e.originalEvent.touches.length === 2 && initialDist) {
                var t1 = e.originalEvent.touches[0];
                var t2 = e.originalEvent.touches[1];
                var dist = Math.hypot(t1.pageX - t2.pageX, t1.pageY - t2.pageY);
                var scale = dist / initialDist;
                $el.trigger('pinch', { scale: scale, distance: dist });
                callback.call(this, scale, dist);
              }
            });
            
            $el.on('touchend', function() { initialDist = null; });
          });
        }
      }
    }
  };

  // 自動註冊所有事件到 $.fn
  $.each(indream.touch.eventList, function(name, config) {
    if (config.handler) {
      $.fn[name] = config.handler;
    } else if (config.nativeEvent) {
      $.fn[name] = function(callback) {
        return this.on(config.nativeEvent, callback);
      };
    }
  });
})(jQuery);

使用示例

// 1. Tap 替代 Click(無 300ms 延遲)
$('#btn').tap(function(e) {
  alert('Tap 觸發,即時響應!');
});

// 2. 長按
$('#item').on('longPress', function(e) {
  showContextMenu(e.originalEvent.changedTouches[0].pageX, e.originalEvent.changedTouches[0].pageY);
});

// 3. 滑動
$('.gallery').swipe(function(dir) {
  if (dir === 'left') nextSlide();
  else if (dir === 'right') prevSlide();
});

// 4. 捏合縮放
$('#image').pinch(function(scale) {
  $(this).css('transform', 'scale(' + scale + ')');
});

// 5. 原生觸摸事件直接用
$('#area').touchStart(function(e) { console.log('手指按下'); });
$('#area').touchMove(function(e) { console.log('手指移動'); });
$('#area').touchEnd(function(e) { console.log('手指抬起'); });

關鍵技術點

  1. 事件委託與觸發:用 trigger 派發自定義事件,解耦業務邏輯。
  2. 300ms 延遲消除:tap 在 touchend 立即觸發,並標記抑制後續 click。
  3. 閾值可配置:移動判定距離、長按時間、滑動最小距離/最大時間均可參數化。
  4. 桌面兼容:同時綁定 click/scroll,無觸摸設備正常工作。

現代替代:Pointer Events

// 統一鼠標/觸摸/筆輸入
el.addEventListener('pointerdown', onDown);
el.addEventListener('pointermove', onMove);
el.addEventListener('pointerup', onUp);
// 配合 touch-action: none 禁用默認滾動/縮放

現代瀏覽器推薦使用 Pointer Events,但上述 jQuery 擴展在舊項目維護中仍有價值。

copyright © 萬盛學電腦網 all rights reserved