移動端框架目前仍相對年輕,但移動 Web 的份額早已不容小覷。剛接觸移動端開發時,很多人的第一反應是 jQuery。從 2.0 版本開始,jQuery 確實在往移動端靠攏,對 H5 的支持有所改善,但整體仍不夠完善。
如果一開始就用 W3C 標準語法加原生 JS 開發,工作量會相當可觀,而且每一步都要操心各移動端浏覽器的兼容——尤其是一些廠商定制系統,很多事件都要單獨適配。因此一個兼容性良好的框架,能省下大量重復勞動。
我們最初選用的是 zepto.js,這個輕量方案在手機浏覽器上表現不錯,但對部分 WP 手機支持不佳,項目做完還得再補一轮兼容,總有一種得不償失的感覺。後來了解到 hammer.js,它體積小、封裝清晰、上手快,兼容性也更全面,於是我們轉向了它。本文基於官網文檔(版本 v2.0.4)做入門梳理,若 API 有更新,請以官網為準。
它是一款開源的移動端腳本框架,專注於觸屏手勢:點擊、滑動、拖動、多點觸控等都能完美支持。它不依賴任何其他庫,體積很小,用法也非常直觀:
<div id="test" class="test"></div>
<script type="text/javascript">
//創建一個新的 hammer 對象並且在初始化時指定要處理的 dom 元素
var hammertime = new Hammer(document.getElementById("test"));
//為該 dom 元素指定觸屏移動事件
hammertime.on("pan", function (ev) {
//控制台輸出
console.log(ev);
});
</script>

1. Pan(拖動):在指定區域內一個手指按下並移動。這是最常用的事件之一,比如側滑呼出功能菜單。可細分的子事件有:Panstart(開始)、Panmove(進行中)、Panend(結束)、Pancancel(取消)、Panleft / Panright / Panup / Pandown(各方向)。
2. Pinch(捏合):兩個或多個手指相互靠近或遠離時觸發。子事件包括:Pinchstart、Pinchmove、Pinchend、Pinchcancel,以及 Pinchin(距離變近)和 Pinchout(距離變遠)。常用於圖片縮放。
3. Press(長按):相當於觸屏版的 click,但要求手指不移動,且按壓時間不少於 500 毫秒。手機上的「復制、粘貼」菜單就是這個邏輯。另有 Pressup 表示按壓結束。
4. Rotate(旋轉):兩個手指以圓弧方式轉動時觸發,就像擰螺絲。子事件有 Rotatestart、Rotatemove、Rotateend、Rotatecancel。
5. Swipe(快速滑動):一個手指在屏上快速劃過,分為 Swipeleft、Swiperight、Swipeup、Swipedown。
6. Tap(輕點):一個手指輕拍或點擊,最大時長 250 毫秒,超過則按 Press 處理。
這裡分享一個親身踩過的坑。曾經做過一個微信版的「連連看」小遊戲:點擊兩個相同圖案即可消除。在 Firefox 上用鼠標測試時一切流暢,但部署到服務器後用手機操作,iPhone 和 WP 都很順,安卓下怎麼調都有卡頓。一開始懷疑是手機性能,換了高配機仍然如此。
反復排查後才發現根源:在安卓觸屏上,Tap 與 click 會同時觸發,而 click 存在幾百毫秒的延遲——先響應 Tap,過一會兒才響應 click。把遊戲裡所有 click 改成 Tap 之後,問題自然消失。這也是 Hammer.js 存在的意義之一:它內部做了延遲消除與手勢識別,響應比原生 click 快得多。
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Pan</title>
<script src="/Script/hammer.js"></script>
<style type="text/css">
html, body { width: 100%; height: 100%; margin: 0px; padding: 0px; }
.test { width: 100%; height: 50%; background: #ffd800; text-align: left; }
.result { width: 100%; height: 50%; background: #b6ff00; text-align: left; }
</style>
</head>
<body>
<div id="test" class="test">事件區域</div>
<div id="result" class="result">事件結果<br /></div>
<script type="text/javascript">
var hammertime = new Hammer(document.getElementById("test"));
hammertime.on("pan", function (e) {
document.getElementById("result").innerHTML += "X偏移量:【" + e.deltaX + "】,Y偏移量:【" + e.deltaY + "】<br />";
console.log(e);
});
</script>
</body>
</html>

<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Pinch</title>
<script src="/Script/hammer.js"></script>
<style type="text/css">
html, body { width: 100%; height: 100%; margin: 0px; padding: 0px; }
.test { width: 100%; height: 50%; background: #ffd800; text-align: left; }
.result { width: 100%; height: 50%; background: #b6ff00; text-align: left; }
</style>
</head>
<body>
<div id="test" class="test">事件區域</div>
<div id="result" class="result">事件結果:捏合觸發<br /></div>
<script type="text/javascript">
var hammertime = new Hammer(document.getElementById("test"));
hammertime.add(new Hammer.Pinch()); //Pinch 需要手動添加
hammertime.on("pinchin", function (e) {
document.getElementById("result").innerHTML += "捏合初觸發<br />";
console.log(e);
});
</script>
</body>
</html>

<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Press</title>
<script src="/Script/hammer.js"></script>
<style type="text/css">
html, body { width: 100%; height: 100%; margin: 0px; padding: 0px; }
.test { width: 100%; height: 50%; background: #ffd800; text-align: left; }
.result { width: 100%; height: 50%; background: #b6ff00; text-align: left; }
</style>
</head>
<body>
<div id="test" class="test">事件區域</div>
<div id="result" class="result">事件結果:按壓超過 500ms 觸發<br /></div>
<script type="text/javascript">
var hammertime = new Hammer(document.getElementById("test"));
hammertime.on("press", function (e) {
document.getElementById("result").innerHTML += "超過 500ms 了<br />";
console.log(e);
});
</script>
</body>
</html>

<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Rotate</title>
<script src="/Script/hammer.js"></script>
<style type="text/css">
html, body { width: 100%; height: 100%; margin: 0px; padding: 0px; }
.test { width: 100%; height: 50%; background: #ffd800; text-align: left; }
.result { width: 100%; height: 50%; background: #b6ff00; text-align: left; }
</style>
</head>
<body>
<div id="test" class="test">事件區域</div>
<div id="result" class="result">事件結果:旋轉觸發<br /></div>
<script type="text/javascript">
var hammertime = new Hammer(document.getElementById("test"));
hammertime.add(new Hammer.Rotate()); //Rotate 需要手動添加
hammertime.on("rotate", function (e) {
document.getElementById("result").innerHTML += "X偏移量:【" + e.deltaX + "】,Y偏移量:【" + e.deltaY + "】<br />";
console.log(e);
});
</script>
</body>
</html>

<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Swipe</title>
<script src="/Script/hammer.js"></script>
<style type="text/css">
html, body { width: 100%; height: 100%; margin: 0px; padding: 0px; }
.test { width: 100%; height: 50%; background: #ffd800; text-align: left; }
.result { width: 100%; height: 50%; background: #b6ff00; text-align: left; }
</style>
</head>
<body>
<div id="test" class="test">事件區域</div>
<div id="result" class="result">事件結果:向左滑動觸發<br /></div>
<script type="text/javascript">
var hammertime = new Hammer(document.getElementById("test"));
hammertime.on("swipeleft", function (e) {
document.getElementById("result").innerHTML += "X偏移量:【" + e.deltaX + "】,Y偏移量:【" + e.deltaY + "】<br />";
console.log(e);
});
</script>
</body>
</html>

<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Tap</title>
<script src="/Script/hammer.js"></script>
<style type="text/css">
html, body { width: 100%; height: 100%; margin: 0px; padding: 0px; }
.test { width: 100%; height: 50%; background: #ffd800; text-align: left; }
.result { width: 100%; height: 50%; background: #b6ff00; text-align: left; }
</style>
</head>
<body>
<div id="test" class="test">事件區域</div>
<div id="result" class="result">事件結果:點擊觸發<br /></div>
<script type="text/javascript">
var hammertime = new Hammer(document.getElementById("test"));
hammertime.on("tap", function (e) {
document.getElementById("result").innerHTML += "點擊觸發了,長按無效<br />";
console.log(e);
});
</script>
</body>
</html>

仔細對比會發現,Pinch 與 Rotate 兩個例子多了一行 hammertime.add(new Hammer.Pinch()) 和 hammertime.add(new Hammer.Rotate()),而另外四個事件沒有。原因在於:執行 new Hammer(htmlElement) 時,Hammer.js 默認已經為 Pan、Press、Swipe、Tap 註冊了識別器,但 Pinch 和 Rotate 需要開發者手動添加。忘記這一步,是新手常見的「事件怎麼都不觸發」的原因之一。
此外,事件對象上還有很多可用屬性,例如 e.deltaX / e.deltaY(偏移量)、e.distance(移動距離)、e.velocity(速度)、e.pointerType(觸控類型)等,做手勢交互時按需取用即可。