不同识别器会使用不同逻辑,根据从相关Input类获取到的事件对象和事件,实现自定义的触屏事件,例如tap、pinch等。
一、继承关系
Recognizer与前面的Input一样,也相当于是个抽象类。
从上图中可以看到,6个子类都会先继承AttrRecognizer类,因为AttrRecognizer类中的2个方法可以共用,attrTest与process,如果自己不实现,就可以直接调用。
二、识别器状态
每个识别器的初始状态是 “POSSIBLE”,每个识别器都会有一个状态周期。
例如做一次 “tap” 操作,浏览器使用了touch相关操作模拟: touchstart -> touchend,而状态是从 STATE_FAILED -> STATE_ENDED。
6种操作的状态走向图如下:
在 manage.js 中recognize方法,就是在根据识别器状态,来给 “curRecognizer” 与 “session.curRecognizer” 赋值,缓存这个当前周期内的状态。
如果识别器的状态是FAILED, CANCELLED 或者 RECOGNIZED (等同于 ENDED),那就要重置为 POSSIBLE,或结束当前识别器周期,让下一个识别器来。
下面的1,2,4,8等这样取值是为了方便位运算。
var STATE_POSSIBLE = 1; var STATE_BEGAN = 2; var STATE_CHANGED = 4; var STATE_ENDED = 8; var STATE_RECOGNIZED = STATE_ENDED; var STATE_CANCELLED = 16; var STATE_FAILED = 32;
三、Recognizer父类中的抽象方法
1. process(inputData)
返回识别器的状态,各个子类的实现逻辑都会不同,如果没有实现,就会引用通用父类AttrRecognizer中的process。
2. getTouchAction()
获取“touch-action”的属性数组
var TOUCH_ACTION_COMPUTE = 'compute'; var TOUCH_ACTION_AUTO = 'auto'; var TOUCH_ACTION_MANIPULATION = 'manipulation'; // not implemented var TOUCH_ACTION_NONE = 'none'; var TOUCH_ACTION_PAN_X = 'pan-x'; var TOUCH_ACTION_PAN_Y = 'pan-y'; getTouchAction: function() { return [TOUCH_ACTION_MANIPULATION]; }
3. reset()
只有 tap.js 与 press.js实现了这个方法
1 reset: function() { 2 clearTimeout(this._timer); 3 }
四、Recognizer父类中的方法
1)recognizeWith(otherRecognizer) 和 dropRecognizeWith(otherRecognizer)
recognizeWith:就是让当前识别器运行的时候同步运行所给的其它识别器(otherRecognizer),就是让几个操作同时触发,例如结合tap和rotate。
dropRecognizeWith:就是解除这层关系。
tap.recognizeWith(new Hammer.Rotate());
上面的代码中 recognizeWith 在内部会调用三次,下面的第17行代码,促使这个方法调用3次。
/** * @param {Recognizer|Array|String} otherRecognizer * @returns {Recognizer} this */ recognizeWith: function(otherRecognizer) { //支持一个识别器组成的数组来作为参数 if (invokeArrayArg(otherRecognizer, 'recognizeWith', this)) { return this; } var simultaneous = this.simultaneous; //如果识别器被添加到了Manager上,也支持将其它识别器(otherRecognizer)的事件名(字符串形式)来作为参数 otherRecognizer = getRecognizerByNameIfManager(otherRecognizer, this); if (!simultaneous[otherRecognizer.id]) { //保存到 simultaneous 数组中 simultaneous[otherRecognizer.id] = otherRecognizer; otherRecognizer.recognizeWith(this);//调用otherRecognizer的方法 } return this; }
manager.js中recognize方法内调用了个 canRecognizeWith 的方法,里面其实就是在根据识别器的ID判断是否存在。
1 canRecognizeWith: function(otherRecognizer) { 2 return !!this.simultaneous[otherRecognizer.id]; 3 }
2)requireFailure(otherRecognizer) 和 dropRequireFailure(otherRecognizer)
requireFailure:与recognizeWith相反,在某个操作的时候,不执行otherRecognizer。也就是只有当其它识别器(otherRecognizer)无效时才执行该识别器。
dropRequireFailure:解除这层关系。
/** * @param {Recognizer|Array|String} otherRecognizer * @returns {Recognizer} this */ requireFailure: function(otherRecognizer) { if (invokeArrayArg(otherRecognizer, 'requireFailure', this)) { return this; } var requireFail = this.requireFail; otherRecognizer = getRecognizerByNameIfManager(otherRecognizer, this); if (inArray(requireFail, otherRecognizer) === -1) { requireFail.push(otherRecognizer);//维护一个requireFail数组 otherRecognizer.requireFailure(this); } return this; }
这个 requireFail 数组在 Recognizer.canEmit 方法中会被调用,返回一个boolean值,用于在 Recognizer.tryEmit 是否能执行子类中的 emit 方法。
在第一篇《基础结构》的操作流程图中,有调用 emit 方法,子类是 Tap。
tryEmit: function(input) { if (this.canEmit()) { return this.emit(input); } // it's failing anyway this.state = STATE_FAILED; }, canEmit: function() { var i = 0; while (i < this.requireFail.length) { if (!(this.requireFail[i].state & (STATE_FAILED | STATE_POSSIBLE))) { return false; } i++; } return true; }