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('手指抬起'); });
trigger 派發自定義事件,解耦業務邏輯。tap 在 touchend 立即觸發,並標記抑制後續 click。click/scroll,無觸摸設備正常工作。// 統一鼠標/觸摸/筆輸入
el.addEventListener('pointerdown', onDown);
el.addEventListener('pointermove', onMove);
el.addEventListener('pointerup', onUp);
// 配合 touch-action: none 禁用默認滾動/縮放
現代瀏覽器推薦使用 Pointer Events,但上述 jQuery 擴展在舊項目維護中仍有價值。