手勢
MIP封裝了單擊,雙擊,滑動等手勢,可在元件中使用
#範例
var util = require('util'); var Gesture = util.Gesture; var customEle = require('customElemenet').create(); var build = function () { var gesture = new Gesture(this.element); // on 可接受多个事件名做为参数,以空格分隔。如 gesture.on('tap swipe') gesture.on('tap', function (event, data) { // 原始事件。如tap事件是通过 touchend 触发,event为tap对应的touchend事件对象 console.log(event); // gesture 计算后的数据。参数介绍见后面 console.log(data.type); // "tap" }); };
初始化參數介紹
gesture 實例化時第二個參數可以傳一個object做為配置參數
範例:
// 默认阻止纵向滑动事件 var gesture = new Gesture(element, { preventY: true });
具體參數介紹:
preventDefault 是否阻止默认事件 preventX 是否阻止横向滑动时的默认事件 preventY 是否阻止纵向滑动时的默认事件 stopPropagation 是否阻止事件冒泡
預設參數:
// 如果初始化时不传入配置参数,会使用下面的配置进行初始化 { preventDefault: false, stopPropagation: false, // 默认会阻止横滑的事件,考虑到浏览器横滑有很多默认操作,所以在这里默认阻止横滑 preventX: true, preventY: false }
gesture 數據物件介紹
資料物件做為事件處理函數的第二個參數傳入。
範例:
gesture.on('tap', function (event, data) { console.log(data); });
通用欄位:
angle 滑动角度,如横滑为0度 deltaTime 从开始到结束的时间间隔。单位是msdeltaX 横轴位移 deltaY 纵轴位移 direction 方向。0: 未变动 1: 上 2:右 3: 下 4: 左 distance 移动距离 pointers 触摸点 timeStamp 事件发生的时间戳 velocity 速度 velocityX 横向速度 velocityY 纵向速度 x 触摸中心点坐标x y 触摸中心点坐标ytype 事件类型
擴充欄位:
各手勢可以向資料物件中擴充欄位。如swipe 事件中的swipeDirection 字段,請看手勢辨識器介紹
手勢辨識器
手勢辨識器可以接收gesture 資料對象,並辨識出具體手勢,觸發具體的手勢事件。
手勢辨識器物件在使用者綁定事件時自動創建,在使用者解綁事件時自動銷毀。
目前有三種內建辨識器:tap、dobuletap、swipe
tap
使用方法:
gesture.on('tap', function (event, data) { console.log('单击'); });
doubletap
#雙擊,如果同時綁定tap和doubletap,tap事件會延遲300ms觸發以判斷是否觸發雙擊。
使用方法:
gesture.on('tap', function (event, data) { console.log('双击'); });
swipe
滑動
#使用方法:
// 使用方法1: gesture.on('swipe', function (event, data) { console.log(data.type); // "swipe" console.log(data.swipeDirection); // "up" or "right" or "down" or "left" }); // 使用方法2: gesture.on('swipeup swipedown', function (event, data) { console.log(data.type) // "swipeup" or "swipedown" console.log(data.swipeDirection) // "up" or "down" });