truthhun/ztouch

Zepto.js v1.0.1 touch extend (Zepto.js v1.0.1 swipe/touch扩展)

zTouch

* Zepto.js v1.0.1 touch extend (Zepto.js v1.0.1 swipe/touch扩展)

Zepto.js v1.0.1版本的touch.js模块引入使用后会导致页面很卡的情况，所以开发了一个新的扩展插件来替换其touch.js。已经过Android/ios测试。

* zTouch特点：

• zTouch.js只包含核心功能函数，不包含任何效果，简洁轻巧;
• 提供丰富的回调参数，可由用户自定义扩展效果（可参考Demo）;
• 支持多种回调函数，方便及时监控及事件处理（实例化前/后回调，touch start/move/end回调）;
• 支持用户自定义手势标准定义(X-Y轴滑动限定，角度限定);
• 支持BOX边界检测，touch超出边界后自动停止回调操作;
• 提供内部属性设置接口，可在内部tPoint中加入用户自定义属性;
• 支持手势横向滑动，同时保证浏览器纵向正常滑动;
• 不会阻止BOX内的其它绑定事件(onclick等);
• 支持多点触摸监控（缩放，旋转）;

由于手机浏览器会阻止JS对gesture手势事件的监听 zTouch.js中对gesture监听接口虽然可以调用，但无法实现手势操作(Android设备测试，IOS设备应该支持)。我们会在后续进行多点touch事件模拟解决。 (最新版zTouch已经去除对gesture事件的监听方法，采用e.touches对多点触摸进行监控，支持两点监控的缩放和旋转操作)

zTouch.js中为事件监听的核心文件。所有的特殊效果可以在回调函数进行个性化定制。

* 主要提供以下回调函数：

beforeCallback (实例化之前触发的回调函数),
sCallback (start callback,touchstart时触发的回调函数),
mCallback (move callback,touchmove时触发的回调函数),
eCallback (end callback,touchend时触发的回调函数)
afterCallback (实例化之后触发的回调函数),

* 回调函数中会传入touch事件相关回调参数：

self:实例化的BOX,
startX:触点起始X,
startY:触点起始Y,
bL:(Box Left) 相对于文档的left偏移,
bT:(Box Top)相对于文档的top偏移,
bW:(Box Width)BOX的宽度,
bH:(Box Height)BOX的高度,
bRb:(Box Right Border)BOX的右边界,
bBb:(Box Bottom Border)BOX的下边界,
endX:触点结束X;
endY:触点结束Y;
mX:(move x distance)X方向滑动距离;
mY:(move y distance)Y方向滑动距离;
direction:手势滑动方向(left/right/false);
angle:单点手势滑动角度;
duration:手势持续时间;
vendor:浏览器前缀(-moz/-webkit/-o/-ms);

tPoint.multiTouch:是否多点触摸(touchmove时可监控);
tPoint.gStartDis:(gisture start distance)手势起始距离;
tPoint.gEndDis:(gisture end distance)手势结束距离;
tPoint.scale:手势缩放比例;
tPoint.rotation:手势旋转角度;

* 同时在外部回调函数中提供修改内部tPoint数据的接口:

    tPoint.setAttr(name,value);

* 调用方法:

<script type="text/javascript">
//传入args初始化参数对象
args={
	iniL:30,//X方向滑动的最小距离
    iniT:50,//Y方向滑动的最大距离
	eCallback:function(tPoint){
		switch(tPoint.direction){
			case "left":
				alert("left");
				break;
			case "right":
				alert("right");
		}
	}
}
$("body").Swipe(args); 
</script>

* 项目地址:

http://chinatjnet.github.io/zTouch/

* Github地址:

https://github.com/chinatjnet/zTouch/

* 演示地址:

http://chinatjnet.github.io/zTouch/demo.html
二维码：