欢迎各位兄弟 发布技术文章

这里的技术是共享的

You are here

Hammer.js

shiping1 的头像

一、前言

移动端框架当前还处在初级阶段,但相对于移动端的应用来说已经有很长时间了。虽然暂时还没有PC端开发的需求量大,但移动端的Web必然是一种趋势,在接触移动端脚本的过程中,最开始想到的是juqery。Jquery2.0版本及以上已经开始偏向移动端,如对h5的支持,但支持还是不够完善,希望jq在后面的版本能够逐渐支持起来。

最初在开发移动端Web的时候使用w3c标准的语法结构和原生的js开发,但相对来说开发量比较大,而且每一步都要考虑各移动端浏览器的兼容,像比较让程序员头痛的大wp手机,很多事件都向w3c申请单独的标准。因此一个好的兼容性架构对于开发者来说可以节省很大一部分工作量。

刚开始接触移动端框架之初也问了一些一直搞前端的朋友,大部份都在百度阿里等工作。参考大家的建议后我们做项目使用了zepto.js(很多搞前端的朋友应该并不陌生)。这个框架有个很大的问题就是不兼容wp手机,使用zepto.js开发完项目后,再针对wp手机兼容做调整总感觉有些“得不偿失”,后来咨询了些朋友,他们所在的公司在开发的时候基本都放弃wp的兼容(我只能对wp说“呵呵”了)。后面就咨询到有用hammer.js进行开发的。我们研究了下,hammer.js轻量级,封装的也比较好。用起来也很方便。兼容性也不错。但网上中文资料比较少,园子写hammer的就更少了。因此有了这篇文章。

此文章基于hammer.js 官网:http://hammerjs.github.io/ ,版本基于v2.0.4。如果该文章的api已过期,请自行到官网查询最新api。此文章只做入门使用。

二、hammer.js是什么

hammer.js是一款开源的移动端脚本框架,他可以完美的实现在移端开发的大多数事件,如:点击、滑动、拖动、多点触控等事件。不需要依赖任何其他的框架,并且整个框架非常小,\在使用时非常简单,代码示例如下:

复制代码
 1  <div id="test" class="test"></div>
 2     <script type="text/javascript">
 3         //创建一个新的hammer对象并且在初始化时指定要处理的dom元素
 4         var hammertime = new Hammer(document.getElementById("test"));
 5         //为该dom元素指定触屏移动事件
 6         hammertime.on("pan", function (ev) {
 7             //控制台输出
 8             console.log(ev);
 9         });
10 </script>
复制代码

三事件架构

hammer.js主要针对触屏的6大事件进行监听。如下图所示:

1、  Pan事件:在指定的dom区域内,一个手指放下并移动事件,即触屏中的拖动事件。这个事件在屏触开发中比较常用,如:左拖动、右拖动等,如手要上使用QQ时向右滑动出现功能菜单的效果。该事件还可以分别对以下事件进行监听并处理:

Panstart:拖动开始、Panmove:拖动过程、Panend:拖动结束、Pancancel:拖动取消、Panleft:向左拖动、Panright:向右拖动、Panup:向上拖动、Pandown:向下拖动

2、  Pinch事件:在指定的dom区域内,两个手指(默认为两个手指,多指触控需要单独设置)或多个手指相对(越来越近)移动或相向(越来越远)移动时事件。该事件事以分别对以下事件进行监听并处理:

Pinchstart:多点触控开始、Pinchmove:多点触控过程、Pinchend:多点触控结束、Pinchcancel:多点触控取消、Pinchin:多点触控时两手指距离越来越近、Pinchout:多点触控时两手指距离越来越远

3、  Press事件:在指定的dom区域内触屏版本的点击事件,这个事件相当于PC端的Click事件,该不能包含任何的移动,最小按压时间为500毫秒,常用于我们在手机上用的“复制、粘贴”等功能。该事件分别对以下事件进行监听并处理:

Pressup:点击事件离开时触发

4、  Rotate事件:在指定的dom区域内,当两个手指或更多手指成圆型旋转时触发(就像两个手指拧螺丝一样)。该事件分别对以下事件进行监听并处理:

Rotatestart:旋转开始、Rotatemove:旋转过程、Rotateend:旋转结束、Rotatecancel:旋转取消

5、  Swipe事件:在指定的dom区域内,一个手指快速的在触屏上滑动。即我们平时用到最多的滑动事件。

Swipeleft:向左滑动、Swiperight:向右滑动、Swipeup:向上滑动、Swipedown:向下滑动

6、Tap事件:在指定的dom区域内,一个手指轻拍或点击时触发该事件(类似PC端的click)。该事件最大点击时间为250毫秒,如果超过250毫秒则按Press事件进行处理。

经验分享:写到这个事件的时候有人必然要问了,在触屏中我们使用Click事件不也可以吗?这个Tap事件与Click事件有什么区别呢?博主也曾经有过这样的疑惑,起初在触屏上处理点击的时候也一直用的click事件,并且没也有出现任何问题,直到有一天为一个公司做了微信版本的“连连看”小游戏,连连看的业务简单来说就是屏幕上有很多图片,当点击两个相同图案的图片时可以在中间产生连接线,并且产生爆破效果后消失。这个游戏刚开始做的时候是在ff浏览器上做的测试,鼠标点击后效果非常流畅,但当游戏部署到服务器上并用手机端操作时,iphone和wp都非常流畅,安卓下不管怎么调都是有卡顿。起初以为是手机性能的问题,但换了高配手机后仍然会有卡顿,游戏也不是不能玩,就是反应慢。经过多次的测试后排除了手机配置的硬件原因,开始怀疑click事件。经过网上查阅后才得知,在安卓触屏上,Tap事件和click事件可以同时触发,但click事件会有几百毫秒的延迟,即先触发Tap事件,过一段时间再触发click事件。后来把游戏的所有click事件修改成Tap事件问题就自然解决了。

四、 使用实例

1、 Pan

代码如下:

复制代码
 1 <!DOCTYPE html>
 2 <html>
 3 <head>
 4     <meta name="viewport" content="width=device-width" />
 5     <title>Pan</title>
 6     <script src="/Script/hammer.js"></script>
 7     <style type="text/css">
 8         html, body {
 9             width: 100%;
10             height: 100%;
11             margin: 0px;
12             padding: 0px;
13         }
14 
15         .test {
16             width: 100%;
17             height: 50%;
18             background: #ffd800;
19             text-align: left;
20         }
21 
22         .result {
23             width: 100%;
24             height: 50%;
25             background: #b6ff00;
26             text-align: left;
27         }
28     </style>
29 </head>
30 <body>
31     <div id="test" class="test">事件区域</div>
32     <div id="result" class="result">事件结果<br /></div>
33     <script type="text/javascript">
34         //创建一个新的hammer对象并且在初始化时指定要处理的dom元素
35         var hammertime = new Hammer(document.getElementById("test"));
36         //添加事件
37         hammertime.on("pan", function (e) {
38             document.getElementById("result").innerHTML += "X偏移量:【" + e.deltaX + "】,Y偏移量:【" + e.deltaY + "】<br />";
39             //控制台输出
40             console.log(e);
41         });
42     </script>
43 </body>
44 </html>
复制代码

效果如下:

2、Pinch

代码如下:

复制代码
 1 <!DOCTYPE html>
 2 <html>
 3 <head>
 4     <meta name="viewport" content="width=device-width" />
 5     <title>Pinch</title>
 6     <script src="/Script/hammer.js"></script>
 7     <style type="text/css">
 8         html, body {
 9             width: 100%;
10             height: 100%;
11             margin: 0px;
12             padding: 0px;
13         }
14 
15         .test {
16             width: 100%;
17             height: 50%;
18             background: #ffd800;
19             text-align: left;
20         }
21 
22         .result {
23             width: 100%;
24             height: 50%;
25             background: #b6ff00;
26             text-align: left;
27         }
28     </style>
29 </head>
30 <body>
31     <div id="test" class="test">事件区域</div>
32     <div id="result" class="result">事件结果:捏合触发<br /></div>
33     <script type="text/javascript">
34         //创建一个新的hammer对象并且在初始化时指定要处理的dom元素
35         var hammertime = new Hammer(document.getElementById("test"));
36         //为该dom元素指定触屏移动事件
37         hammertime.add(new Hammer.Pinch());
38         //添加事件
39         hammertime.on("pinchin", function (e) {
40             document.getElementById("result").innerHTML += "捏合初触发<br />";
41             //控制台输出
42             console.log(e);
43         });
44     </script>
45 </body>
46 </html>
复制代码

效果如下:

3、Press

代码如下:

复制代码
 1 <!DOCTYPE html>
 2 <html>
 3 <head>
 4     <meta name="viewport" content="width=device-width" />
 5     <title>Press</title>
 6     <script src="/Script/hammer.js"></script>
 7     <style type="text/css">
 8         html, body {
 9             width: 100%;
10             height: 100%;
11             margin: 0px;
12             padding: 0px;
13         }
14 
15         .test {
16             width: 100%;
17             height: 50%;
18             background: #ffd800;
19             text-align: left;
20         }
21 
22         .result {
23             width: 100%;
24             height: 50%;
25             background: #b6ff00;
26             text-align: left;
27         }
28     </style>
29 </head>
30 <body>
31     <div id="test" class="test">事件区域</div>
32     <div id="result" class="result">事件结果:按压超过500ms触发<br /></div>
33     <script type="text/javascript">
34         //创建一个新的hammer对象并且在初始化时指定要处理的dom元素
35         var hammertime = new Hammer(document.getElementById("test"));
36         //添加事件
37         hammertime.on("press", function (e) {
38             document.getElementById("result").innerHTML += "超过500ms了<br />";
39             //控制台输出
40             console.log(e);
41         });
42     </script>
43 </body>
44 </html>
复制代码

效果如下: 

4、Rotate

代码如下:

复制代码
 1 <!DOCTYPE html>
 2 <html>
 3 <head>
 4     <meta name="viewport" content="width=device-width" />
 5     <title>Rotate</title>
 6     <script src="/Script/hammer.js"></script>
 7     <style type="text/css">
 8         html, body {
 9             width: 100%;
10             height: 100%;
11             margin: 0px;
12             padding: 0px;
13         }
14 
15         .test {
16             width: 100%;
17             height: 50%;
18             background: #ffd800;
19             text-align: left;
20         }
21 
22         .result {
23             width: 100%;
24             height: 50%;
25             background: #b6ff00;
26             text-align: left;
27         }
28     </style>
29 </head>
30 <body>
31     <div id="test" class="test">事件区域</div>
32     <div id="result" class="result">事件结果:旋转触发<br /></div>
33     <script type="text/javascript">
34         //创建一个新的hammer对象并且在初始化时指定要处理的dom元素
35         var hammertime = new Hammer(document.getElementById("test"));
36         //为该dom元素指定触屏移动事件
37         hammertime.add(new Hammer.Rotate());
38         //添加事件
39         hammertime.on("rotate", function (e) {
40             document.getElementById("result").innerHTML += "X偏移量:【" + e.deltaX + "】,Y偏移量:【" + e.deltaY + "】<br />";
41             //控制台输出
42             console.log(e);
43         });
44     </script>
45 </body>
46 </html>
复制代码

效果如下:

5、Swipe

代码如下:

复制代码
 1 <!DOCTYPE html>
 2 <html>
 3 <head>
 4     <meta name="viewport" content="width=device-width" />
 5     <title>Swipe</title>
 6     <script src="/Script/hammer.js"></script>
 7     <style type="text/css">
 8         html, body {
 9             width: 100%;
10             height: 100%;
11             margin: 0px;
12             padding: 0px;
13         }
14 
15         .test {
16             width: 100%;
17             height: 50%;
18             background: #ffd800;
19             text-align: left;
20         }
21 
22         .result {
23             width: 100%;
24             height: 50%;
25             background: #b6ff00;
26             text-align: left;
27         }
28     </style>
29 </head>
30 <body>
31     <div id="test" class="test">事件区域</div>
32     <div id="result" class="result">事件结果:向左滑动触发<br /></div>
33     <script type="text/javascript">
34         //创建一个新的hammer对象并且在初始化时指定要处理的dom元素
35         var hammertime = new Hammer(document.getElementById("test"));
36         //添加事件
37         hammertime.on("swipeleft", function (e) {
38             document.getElementById("result").innerHTML += "X偏移量:【" + e.deltaX + "】,Y偏移量:【" + e.deltaY + "】<br />";
39             //控制台输出
40             console.log(e);
41         });
42     </script>
43 </body>
44 </html>
复制代码

效果如下:

6、Tab

代码如下:

复制代码
 1 <!DOCTYPE html>
 2 <html>
 3 <head>
 4     <meta name="viewport" content="width=device-width" />
 5     <title>Tap</title>
 6     <script src="/Script/hammer.js"></script>
 7     <style type="text/css">
 8         html, body {
 9             width: 100%;
10             height: 100%;
11             margin: 0px;
12             padding: 0px;
13         }
14 
15         .test {
16             width: 100%;
17             height: 50%;
18             background: #ffd800;
19             text-align: left;
20         }
21 
22         .result {
23             width: 100%;
24             height: 50%;
25             background: #b6ff00;
26             text-align: left;
27         }
28     </style>
29 </head>
30 <body>
31     <div id="test" class="test">事件区域</div>
32     <div id="result" class="result">事件结果:点击触发<br /></div>
33     <script type="text/javascript">
34         //创建一个新的hammer对象并且在初始化时指定要处理的dom元素
35         var hammertime = new Hammer(document.getElementById("test"));
36         //添加事件
37         hammertime.on("tap", function (e) {
38             document.getElementById("result").innerHTML += "点击触发了,长按无效<br />";
39             //控制台输出
40             console.log(e);
41         });
42     </script>
43 </body>
44 </html>
复制代码

效果如下:

上述的实例还是有所区别的。在Pinch事件和Rotate事件中,我们用了hammertime.add(new Hammer.Pinch());和hammertime.add(new Hammer.Rotate ());而其他四个事件没有用,而是直接添加了事件的监听程序。原因在于,我们在new Hammer(htmlElement)的时候,Hammer.js默认对Pan、Press、Swipe和Tab事件进行了监听。但没有对Pinch和Rotate事件进行监听。

五、源码下载

点我下载源码

六、后纪(请看18楼-25楼的回复)

关于hammer.js的swipeup事件不触发,原因是hammer.js在创建一个新对象时默认会添加些常用事件(详细见:http://hammerjs.github.io/getting-started/)。注意,是常用事件,而不是全部事件。swipe事件官方说是在常用事件内,但实际不在常用事件内。因此,要对这些非常用事件单独做监听,伪代码如下所示:

1 var hammertime = new Hammer(document.getElementById("test"));
2 hammertime.add(new Hammer.Swipe());
3 hammertime.on("swipeup",function(){.......})

当一个对象需要多个事件时,经官方api和测试结果,需要对一个事件添加多个监听,伪代码如下所示:

1 var hammertime = new Hammer(document.getElementById("test"));
2 hammertime.add(new Hammer.Swipe());
3 hammertime.on("swipeup",function(){.......})
4 var hammertime1 = new Hammer(document.getElementById("test"));
5 hammertime.on("swipeleft",function(){.......})

关于多事件绑定hammer.js官网当前版本并未给出好的写法,希望以后的版本能出现吧。

版权:http://www.cnblogs.com/iamlilinfeng

 
« 上一篇:jquery触屏幻灯片
» 下一篇:MVC缓存
posted on 2015-01-22 07:45 李林峰的园子 阅读(14541) 评论(31编辑 收藏
 

 
  
#1楼 2015-01-22 08:21 | garfieldzf  
这么早就起来写博客,精神可嘉。
  
#2楼[楼主2015-01-22 08:26 | 李林峰的园子  
@garfieldzf
这么早就起来看博客,精神可嘉。哈哈。
  
#3楼 2015-01-22 09:39 | 里沃特  
@李林峰的园子
引用@garfieldzf
这么早就起来看博客,精神可嘉。哈哈。


这么早起来回复,精神可嘉。
  
#4楼 2015-01-22 09:39 | 小武子技術博客  
  
#5楼 2015-01-22 09:42 | 里沃特  
刚下载看了下,楼主是说压缩后并且去掉注释是那么小吧。我看了看没压缩有60多K,不过里面的代码写的不错,就是注释都是英文的。
  
#6楼[楼主2015-01-22 09:48 | 李林峰的园子  
@里沃特
官方下压缩的吧,我下的是源码哦。
  
#7楼 2015-01-22 10:29 | ICupid  
为什么不用JqueryMobile
  
#8楼 2015-01-22 10:57 | joyber  
  
#9楼[楼主2015-01-22 13:16 | 李林峰的园子  
@ICupid
jqmobile就是个渣,根本没法用。jquerymobile更像移动端的富客户端框架。
  
#10楼[楼主2015-01-22 13:16 | 李林峰的园子  
@joyber
同上。
  
#11楼 2015-01-22 13:56 | codezyc  
好文,赞一个
  
#12楼 2015-01-30 04:00 | 正好只有七个字  
请问如果我要一次绑定多个htmlelement该怎么写呢
  
#13楼 2015-03-17 11:04 | 蓬stephen蓬  
您好,这个我测试的时候,需要把jquery的源码也引进来才可以吧。否则似乎无法实例化hammertime。
  
#14楼[楼主2015-03-17 11:31 | 李林峰的园子  
@蓬stephen蓬
可以引用jquery。
  
#15楼[楼主2015-03-17 11:31 | 李林峰的园子  
@正好只有七个字

当前API上还没有提供多个绑定。
  
#16楼 2015-03-21 11:43 | 周猩猩  
hammer有动画方法吗
  
#17楼[楼主2015-03-23 15:05 | 李林峰的园子  
@周猩猩
动画通过html5做渲染,hammer只提供事件的支持。
  
#18楼 2015-03-30 15:07 | 楚小秋  
swipeup和swipedown根本没有用哇
  
#19楼[楼主2015-03-30 15:11 | 李林峰的园子  
@楚小秋
我一般用left和right,没用up和down,但应该是可用的。
  
#20楼 2015-03-30 15:18 | 楚小秋  
@李林峰的园子
我单独试了up和down半天,发现不行,直接用swipe做测试,上下都没反应,源码我不懂调试,现在这个项目需要用到,百度的touch.js不兼容IE,挺纠结的
  
#21楼[楼主2015-03-30 15:24 | 李林峰的园子  
@楚小秋
swipe事件我们一直在用啊。没啥问题,你的写法不对吧。hammer.js兼容性还是不错的。
  
#22楼 2015-03-30 15:32 | 楚小秋  
@李林峰的园子
为了排除其他可能的错误,我直接用了你的代码,只是把你的swipeleft换成了swipe,上下均无反应,IE11,Chrome41,火狐36都一样
  
#23楼[楼主2015-03-30 15:35 | 李林峰的园子  
@楚小秋
汗,这是触屏框架,要在手机上测试。PC机上肯定不好使啊,不过你非要用pc测试的话用火狐-【开发者】-【响应式布局】-打开触屏事件。
  
#24楼 2015-03-30 15:44 | 楚小秋  
@李林峰的园子
我当然是在移动端测试的啊,不行滴,你要不要亲自试试
  
#25楼[楼主2015-03-30 15:45 | 李林峰的园子  
@楚小秋
你加我QQ群
  
#26楼 2015-05-07 11:07 | 神经质女孩  
怎么测试效果?
  
#27楼[楼主2015-05-07 21:36 | 李林峰的园子  
@神经质女孩
下代码并部署到iis上,用浏览器或手机测试。
  
#28楼 2015-06-05 17:28 | tong酱  
楼主你的演示链接不能访问了啊!T_T
  
#29楼 2015-06-08 18:24 | yooly_chen  

楼主,打错一个字母。写得很好,受教了,谢谢
  
#30楼 2015-07-02 11:42 | 周衣谷  
学习下 公司正好要用这个
  
#31楼 2015-07-24 16:44 | Carloos  
多谢楼主, 很详细的入门使用

看到楼上有说swipeup 和 swipedown 不能用的,hammerjs 的垂直方向滑动默认是关闭的,需要手动打开才行
1
2
3
4
5
6
var hammertime = new Hammer(document.getElementById("test"));
hammertime.get('swipe').set({ direction: Hammer.DIRECTION_VERTICAL});
 
hammertime.on("swipedown swipeup"function (e) {
            console.log( "X偏移量:[" + e.deltaX + "],Y偏移量:[" + e.deltaY + "]");
        });


来自  http://www.cnblogs.com/iamlilinfeng/p/4239957.html
 
 

普通分类: