gesture,一个适用于移动终端和桌面浏览器的事件库,事件包括tap, doubletap, taphold, flick, zoom(zoomstart, zoom, zoomend, zoomin以及zoomout), rotate(rotatestart, ratate以及rotateend), drag & drop(dragstart, drag, dragend, dragenter, dragover, dragleave以及drop)等。
优点:

• 使用方便:类似jQuery的事件绑定API,支持链式调用,支持事件代理。
• 扩展方便:根据gesture.js对原生mouse/touch事件的封装,很容易写出一个新的事件类型。
• 调试方便:可以现代桌面浏览器上开发,然后在移动终端调试。

首先看个例子吧,模拟iOS界面

创建一个gesture对象,然后可以绑定事件。
@param elem: 需要绑定事件的DOM元素,必选。可以是字符串(selector),DOM元素,DOM元素数组,NodeList,HTMLCollection或者jQuery对象。
@return g,拥有了on,tap,doubletap等方法的对象。

绑定事件。
@param type: 字符串,必选。需要绑定的事件类型。支持命名空间。如有多个,用空格分隔,如"tap taphold.namespace"。
@param selector: 字符串,可选。将事件代理给某些子元素=querySelectorAll(selector)。
@param data: 对象,可选。绑定事件时将一些数据传递给处理函数。
@param callback: 函数,必选。事件触发时的处理函数。
@return g对象。

解除事件。由于type参数可以表示事件类型或(和)命名空间,解除事件的时候,需要事件类型,命名空间,选择器和处理函数需要同时相同才能解除,如果存在的话。
@param type: 字符串,必选。需要解除的事件类型。支持命名空间。如有多个,用空格分隔,如".namespace"。
@param selector: 字符串,可选。解除代理给selector指定的子元素上的事件。
@param callback: 函数,可选。解除绑定在某事件上的某个函数。
@return g对象。

使用代码触发某类事件。
@param type: 字符串,必选。需要触发的事件类型。如"tap"。
@return g对象。

绑定tap事件。
@param selector: 字符串,可选。将事件代理给某些子元素=querySelectorAll(selector)。
@param data: 对象,可选。绑定事件时将一些数据传递给处理函数。
@param callback: 函数,必选。绑定在tap事件上的某个处理函数。
@param namespace: 字符串,可选。命名空间。
@return g对象。
同样地,有doubletap,taphold,zoomin,zoomout,flick,scroll等方法。

设置或者获取时间判断的条件。
@param k: 字符串,必选。
@param v: 字符串,可选。为空表示获取该@k值,否则设置@k=@v。
@return 当前系统中@param k的值。
@k的值可以是以下之一:
'tap_max_distance': tap事件的条件,开始和结束时手指移动距离最大为30px。
'tap_max_duration': tap事件的条件,持续时间最大是300ms。(默认为Number.MAX_VALUE,即不管按下多长时间,都是tap。在taphold.js中将此值修改为300ms, 即小于等于300ms是tap,大于300ms是taphold。)
'doubletap_max_interval': 双击事件中,两次单击之间的时间间隔最大为250ms。
'flick_min_x_or_y': flick事件中,x或y方向最小移动距离是30px。
'zoomout_max_scale': zoomout事件中,两个手指之间的距离最大是初始的0.83倍。
'zoomin_min_scale': zoomin事件中,两个手指之间的距离最小是初始的1.2倍。
'dragstart_after_touchstart': drag事件中,从touchstart到dragstart触发之间的时间间隔。

@param e: 原生事件e。
@return pageX值。

@param e: 原生事件e。
@return pageX值。

@param p1: [x, y]元组。
@param p2: [x, y]元组。
@return p1和p2两点之间的距离。

@param event: 字符串,必选。注册的事件类型。如有多个,用空格分隔,如"zoomin zoomout"。
@param handler: 对象,必选。一个包含touchstart,touchmove,touchend或者gesturestart,gesturechange,gestureend等属性的对象。分别表示这些事件触发时的处理函数,用于判断是否是@event事件。
@param ifBind: 函数,可选。绑定该事件时,执行一些设置属性等操作。
@return g函数。

@param event: 字符串,必选。需要注销的事件类型。如有多个,用空格分隔,如"zoomin zoomout"。 @return g函数。

@param name: 字符串,必选。需要新建的事件名称。
@param e: 对象,必选。原生对象e,一般是touchend或者gestureend事件。
@param attrs: 对象,可选。用于设置一些特殊属性,如flick事件中表示方向的属性direction。
@return 无。

让原生事件比如touchstart、keydown等也可以通过型为g().touchstart()方式使用。
@param types: (不定数目的)字符串,必选。一个事件名称比如'keydown',或者使用空格分隔的多个同类型事件,比如'transitionend webkitTransitionEnd'。如果是后者,则可以通过第一个事件名称来监听这几种类型事件。同类型是指不同系统(比如Windows和iOS)中对同一(或相似)事件有着不同事件名,比如mousedown和touchstart,也可以是不同浏览器对W3C规范中的事件加了浏览器厂商前缀,比如webkitTransitionEnd和transitionend。
@return g函数。

g.enableNativeEvents('keydown', 'transitionend webkitTransitionEnd');
gElemPages.keydown(function(e){
 // e should be a keydown event
});
gElemPages.transitionend(function(e){
 // e maybe a transitionend or webkitTransitionEnd event
});

1. gesture.js

2. tap.js 引入tap事件类型,默认地tap事件在持续时间上没有限制,手指或者鼠标移动距离应小于30px。

3. doubletap.js
   引入doubletap事件类型,默认地两次tap之间的间隔小于250ms,则认定为是doubletap事件。但一次doubletap事件触发之前,肯定会有两次tap事件触发。

4. tap-doubletap.js 引入tap和doubletap事件类型,也许你对tap.js和doubeltap.js的组合不够满意,不希望doubletap事件触发时,会触发两次tap事件,那么这个脚本就是为你准备的。每一个tap事件发生时,总要等待一段时间,直到250ms之后或者另一个tap事件发生,如果是前者,则触发一个tap事件,否则触发一个doubeltap事件。

5. extend/tap-doubletap.js 引入4. tap-doubletap.js文件以后,所有的tap事件都要延时250ms(可配置),但是有时候我们希望,如果一个元素同时绑定了tap和doubletap时,tap事件才会延时。如果一个元素仅仅绑定了tap事件,那么tap事件会立即触发。

6. taphold.js
   引入taphold事件类型,首先修改tap事件最大持续时间为300ms,此时原本的tap事件就会被区分为两种,持续时间大于300ms的,则会定义为taphold事件。

7. flick.js
   引入flick事件类型,条件是移动距离必须大于30px。flick仅仅是事件,即手指或鼠标移动过程中不会对元素产生影响,比如,不会拖动元素。这点是和drag区分开的。flick有一个属性direction,表示向哪个方向滑动,可能取值为up,down,left和right。

8. swipe.js
   引入了swipestart,swipe和swipeend三个事件。和flick事件类似,但是flick关注的滑动结果,而swipe关注的滑动过程。

gElemPages.swipestart(function(e){
 left = parseInt(elemPages.style.left, 10) || 0;
}).swipe(function(e){
 elemPages.style.left = left + e.deltaX + 'px';
 // 可以通过e.deltaX, e.deltaY获得X和Y方向上相对初始位置的偏移量
}).swipeend(function(e){
 // 可以通过e.speedX, e.speedY获得X和Y方向上的平均速度
 // 可以通过e.deltaX, e.deltaY获得X和Y方向上相对初始位置的偏移量
});

9. zoomin-zoomout.js(需要多点触控支持)
   引入zoomin和zoomout事件类型,分别表示两个手指背离中点移动,向中点移动。默认地zoomin需要touch结束时两手指距离是开始时的至少1.2倍,zoomout最大是0.83倍。此事件只适用于支持multi-touch的移动设备,比如在Android2.X中是不支持的。

10. zoom.js(需要多点触控支持)
    引入zoomstart,zoom和zoomend事件,可以通过e.scale来获取相对zoomstart(gesturestart)事件时的缩放比例。如果发现zoom事件触发过于频繁,可以通过g.opt('zoom_min_step', 1.1);来设置,只有当相对上一次zoom/zoomstart事件缩放比例达到1.1倍时才会触发zoom事件。示例/test/rotate-zoom.html

g('#zoom').zoomstart(function(e){
 // do something
}).zoom(function(e){
 // e.scale
}).zoomend(function(e){
 // e.scale
});

11. rotate.js(需要多点触控支持)
    引入rotatestart,rotate和rotateend事件,可以通过e.rotation来获取相对rotatestart(gesturestart)事件时的旋转角度。如果发现rotate事件触发过于频繁,可以通过g.opt('rotate_min_step', 1);来设置,只有当相对上一次rotate/rotatestart事件旋转大于1°时才会触发rotate事件。示例/test/rotate-zoom.html

g('#rotatezoom').rotatestart(function(){
}).rotate(function(e){
 // e.rotation
}).rotateend(function(e){
 // e.rotation
});

12. drag.js
    引入drag 行为。示例/test/drag.html

g('#item').drag({
 touchstart: function(){},
 touchmove : function(){},
 touchend : function(){},
 container : '#container', //设置拖动范围
 helper : 'no' //实时拖动该元素
});

13. dragdrop-delegatable.js
    引入dragstart, drag, dragend 和 dragenter, dragover, dragleave, drop事件。示例/test/dragdrop-delegatable.html

g('#container')
 .on('dragstart', '.removable', function(){})
 .on('drag', '.removable', function(){})
 .on('dragend', '.removable', function(){});
g('#container')
 .on('dragenter', '.recyclebin', function(){})
 .on('dragover', '.recyclebin', function(){})
 .on('dragleave', '.recyclebin', function(){})
 .on('drop', '.recyclebin', function(){});

14. dragdrop-html5.js
    引入drag和drop 行为。对于支持HTML5 drag & drop API的浏览器,直接使用该API。对于不支持该API的浏览器,则会通过touch或者mouse事件模拟该API。有些浏览器需要调用e.preventDefault(),如FireFox,有些不需要,如Chrome,关于这点是需要你来做的。如果你不想关心这些,那么可以使用g.support.draggable = false来强制不使用HTML5 drag & drop API。示例/test/dragdrop-html5.html

g('.removable').draggable(ondragstart, ondrag, ondragend);
g('.recyclebin').dropable(ondragenter, ondragover, ondragleave, ondrop);

// 支持事件代理,支持同时绑定多个事件,支持namespace,支持链式调用
// 支持的事件包括tap,doubletap,taphold,flick,zoomin和zoomout。
g('#menu').on('tap doubletap.namespace', 'li', function(e){
 e.preventDefault();
}).doubletap(function(e){
 console.info(e.type);
});

只需要按照以下步骤即可自定义压缩gesture。
(1) 执行命令npm install webtools
(2) 打开tools/minimize.js,注释掉你不需要的脚本文件,并修改initScript内容(比如删除,如果不需要的话)
(3) 执行命令node minimize.js,此步骤会生成一个新文件gesture.min.js
(4) 将gesture.min.js引入到网站中

或者使用grunt uglify命令。

######1.0.4 修改方法g.enbaleNativeEvent(type, alias)变成g.enbaleNativeEvents(types1[, types2, ...]) ######1.0.3 新增方法g.enbaleNativeEvent(type, alias), dragdrop-delegatable.js中的move事件使用捕获阶段。
######1.0.2 修正on(event.namespace, selector, callback)方法中未能正确设置namespace的问题 #2. ######1.0.1 dragdrop-delegatable.js文件中的dragstart, drag, dragend 和 dragenter, dragover, dragleave, drop支持代理方式调用。更新文件,添加注释。 ####1.0.0 (Initial Version)