這是一個以原生觸控事件打造的多點觸控通用元件,可在 iOS、Android 手機與平板等多種裝置上運作,能判斷單指的上、下、左、右滑動,也能以雙指計算縮放比例。
<html>
<head>
<title>手指觸摸事件</title>
<style type="text/css">
#touchable { height: 75px; width: 197px; background-color: #0033CC; color: #FFCC66; text-align: center; }
#output { height: 200px; width: 200px; }
</style>
<script src="javascript/hzTouch.js" type="text/javascript"></script>
</head>
<body>
<div id="touchable">用來判斷上下移動</div>
<br/>
<textarea id="output"></textarea>
<script>
// 觸摸後的回呼
// 參數依序為:第一觸點起訖座標、第二觸點起訖座標、觸摸類型、觸摸值
function myCallBack(FirstStartX, FirstStartY, FirstEndX, FirstEndY,
SecondStartX, SecondStartY, SecondEndX, SecondEndY,
mTouchType, TouchValue) {
var output = document.getElementById("output");
output.innerHTML = "第一觸點開始:" + FirstStartX + ":" + FirstStartY + "\n";
output.innerHTML += "第一觸點結束:" + FirstEndX + ":" + FirstEndY + "\n";
switch (mTouchType) {
case TouchType.Up: output.innerHTML += "向上移動了:" + TouchValue + "\n"; break;
case TouchType.Down: output.innerHTML += "向下移動了:" + TouchValue + "\n"; break;
case TouchType.Left: output.innerHTML += "向左移動了:" + TouchValue + "\n"; break;
case TouchType.Right: output.innerHTML += "向右移動了:" + TouchValue + "\n"; break;
case TouchType.Zoom:
output.innerHTML += "第二觸點開始:" + SecondStartX + ":" + SecondStartY + "\n";
output.innerHTML += "第二觸點結束:" + SecondEndX + ":" + SecondEndY + "\n";
output.innerHTML += "縮放比例是:" + TouchValue + "\n";
break;
default: break;
}
}
// 為指定 DOM 元素建立觸控物件
var testTouch = new YXMTouch('touchable', 200, "output", false, myCallBack);
</script>
</body>
</html>
這個檔案負責兩件事:動態注入 viewport 相關的 meta 標籤以避免行動瀏覽器預設縮放干擾手勢,以及封裝 YXMTouch 建構函式。
// 動態寫入 meta,確保頁面以裝置寬度呈現且停用使用者縮放
var meta = document.createElement('meta');
meta.setAttribute('name', 'HandheldFriendly');
meta.setAttribute('content', 'True');
document.getElementsByTagName('head')[0].appendChild(meta);
meta = document.createElement('meta');
meta.setAttribute('name', 'viewport');
meta.setAttribute('content', 'width=device-width; initial-scale=1.0; maximum-scale=1.0; user-scalable=0;');
document.getElementsByTagName('head')[0].appendChild(meta);
// 手勢類型定義
var TouchType = { Up: 1, Down: 2, Left: 3, Right: 4, Zoom: 5 };
// 單指操作時阻止頁面滾動,避免與手勢判定互相干擾
function documentTouchEvent(event) {
if (event.touches.length == 1) {
switch (event.type) {
case "touchstart": event.preventDefault(); break;
case "touchend": event.preventDefault(); break;
case "touchmove": event.preventDefault(); break;
}
}
}
document.addEventListener("touchstart", documentTouchEvent, false);
document.addEventListener("touchend", documentTouchEvent, false);
document.addEventListener("touchmove", documentTouchEvent, false);
// 兩座標間的直線距離
function CoordinateDistance(x1, y1, x2, y2) {
return Math.sqrt(Math.pow(x1 - x2, 2) + Math.pow(y1 - y2, 2));
}
// 以兩指間距離的比值計算縮放比例
function Scaling(x1, y1, x2, y2, x3, y3, x4, y4) {
return (CoordinateDistance(x2, y2, x4, y4) / CoordinateDistance(x1, y1, x3, y3)).toFixed(2);
}
function YXMTouch(TouchObjId, MinDelay, LogObjId, IsLog, CallBack) {
var minTime = MinDelay;
var startTime = 0;
var SX = 0, SY = 0, EX = 0, EY = 0;
var SX1 = 0, SY1 = 0, EX1 = 0, EY1 = 0;
var output = document.getElementById(LogObjId);
var isLog = IsLog == null ? false : IsLog;
function handleTouchEvent(event) {
switch (event.type) {
case "touchstart":
SX = event.touches[0].clientX;
SY = event.touches[0].clientY;
if (this.isLog) output.innerHTML = "觸摸開始0 (" + SX + "," + SY + ")" + "\n";
try {
SX1 = event.touches[1].clientX;
SY1 = event.touches[1].clientY;
if (this.isLog) output.innerHTML = "觸摸開始1 (" + SX1 + "," + SY1 + ")" + "\n";
} catch (err) { }
startTime = event.timeStamp;
break;
case "touchend":
startTime = 0;
if (this.isLog) output.innerHTML += "觸摸結束 (" +
event.changedTouches[0].clientX + "," + event.changedTouches[0].clientY + ")" + "\n";
break;
case "touchmove":
event.preventDefault();
var currentTime = event.timeStamp;
if (startTime !== 0 && currentTime - startTime > minTime) {
EX = event.changedTouches[0].clientX;
EY = event.changedTouches[0].clientY;
try {
EX1 = event.touches[1].clientX;
EY1 = event.touches[1].clientY;
} catch (err) { }
CallBackTouchEnd();
}
break;
}
}
function CallBackTouchEnd() {
startTime = 0;
var mTouchType;
var mValue;
// 兩指都在,判定為縮放
if ((SX1 !== 0) && (SY1 !== 0) && (EX1 !== 0) && (EY1 !== 0)) {
mTouchType = TouchType.Zoom;
mValue = Scaling(SX, SY, EX, EY, SX1, SY1, EX1, EY1);
} else {
// 單指:比較位移量,取變化較大的軸來判定方向
var DiffY = Math.abs(EY - SY);
var DiffX = Math.abs(EX - SX);
if (DiffY >= DiffX) {
mValue = DiffY;
mTouchType = (EY >= SY) ? TouchType.Down : TouchType.Up;
} else {
mValue = DiffX;
mTouchType = (EX >= SX) ? TouchType.Right : TouchType.Left;
}
}
if (this.isLog) {
output.innerHTML += "開始:" + SX + ":" + SY + "\n";
output.innerHTML += "結束:" + EX + ":" + EY + "\n";
switch (mTouchType) {
case TouchType.Up: output.innerHTML += "向上移動了:" + mValue + "\n"; break;
case TouchType.Down: output.innerHTML += "向下移動了:" + mValue + "\n"; break;
case TouchType.Left: output.innerHTML += "向左移動了:" + mValue + "\n"; break;
case TouchType.Right: output.innerHTML += "向右移動了:" + mValue + "\n"; break;
case TouchType.Zoom:
output.innerHTML += "開始1:" + SX1 + ":" + SY1 + "\n";
output.innerHTML += "結束1:" + EX1 + ":" + EY1 + "\n";
output.innerHTML += "縮放比例是:" + mValue + "\n";
break;
default: break;
}
}
CallBack(SX, SY, EX, EY, SX1, SY1, EX1, EY1, mTouchType, mValue);
SX = 0; SY = 0; EX = 0; EY = 0;
SX1 = 0; SY1 = 0; EX1 = 0; EY1 = 0;
}
document.getElementById(TouchObjId).addEventListener("touchstart", handleTouchEvent, false);
document.getElementById(TouchObjId).addEventListener("touchmove", handleTouchEvent, false);
document.getElementById(TouchObjId).addEventListener("touchend", handleTouchEvent, false);
}
new YXMTouch 的五個參數分別是:要監聽的元素 id、最小觸發延遲(毫秒,可避免手勢過於靈敏)、用於輸出除錯訊息的元素 id、是否開啟日誌、以及自訂的回呼函式。
方向判定採「比較 X 與 Y 位移量,取較大者」的策略;縮放則以起始兩指距離為分母、結束兩指距離為分子,四捨五入到小數第二位作為比例。若要擴充更多手勢(例如旋轉),可在 TouchType 中新增常數,並在 CallBackTouchEnd 裡加入角度計算即可。