1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
//>>built
define("dojox/gesture/tap", [
"dojo/_base/kernel",
"dojo/_base/declare",
"dojo/_base/lang",
"./Base",
"../main"
], function(kernel, declare, lang, Base, dojox){
// module:
// dojox/gesture/tap
/*=====
dojox.gesture.tap = {
// summary:
// This module provides tap gesture event handlers:
//
// 1. dojox.gesture.tap: 'tap' event
//
// 2. dojox.gesture.tap.hold: 'tap.hold' event
//
// 3. dojox.gesture.tap.doubletap: 'tap.doubletap' event
//
// example:
// A. Used with dojo.connect()
// | dojo.connect(node, dojox.gesture.tap, function(e){});
// | dojo.connect(node, dojox.gesture.tap.hold, function(e){});
// | dojo.connect(node, dojox.gesture.tap.doubletap, function(e){});
//
// B. Used with dojo.on
// | define(['dojo/on', 'dojox/gesture/tap'], function(on, tap){
// | on(node, tap, function(e){});
// | on(node, tap.hold, function(e){});
// | on(node, tap.doubletap, function(e){});
//
// C. Used with dojox.gesture.tap.* directly
// | dojox.gesture.tap(node, function(e){});
// | dojox.gesture.tap.hold(node, function(e){});
// | dojox.gesture.tap.doubletap(node, function(e){});
//
// Though there is always a default gesture instance after being required, e.g
// | require(['dojox/gesture/tap'], function(){...});
//
// It's possible to create a new one with different parameter setting:
// | var myTap = new dojox.gesture.tap.Tap({holdThreshold: 300});
// | dojo.connect(node, myTap, function(e){});
// | dojo.connect(node, myTap.hold, function(e){});
// | dojo.connect(node, myTap.doubletap, function(e){});
};
=====*/
kernel.experimental("dojox.gesture.tap");
// Declare an internal anonymous class which will only be exported
// by module return value e.g. dojox.gesture.tap.Tap
var clz = declare(/*===== "dojox.gesture.tap", =====*/Base, {
// defaultEvent: [readonly] String
// Default event - 'tap'
defaultEvent: "tap",
// subEvents: [readonly] Array
// List of sub events, used by being
// combined with defaultEvent as 'tap.hold', 'tap.doubletap'.
subEvents: ["hold", "doubletap"],
// holdThreshold: Integer
// Threshold(in milliseconds) for 'tap.hold'
holdThreshold: 500,
// holdThreshold: Integer
// Timeout (in milliseconds) for 'tap.doubletap'
doubleTapTimeout: 250,
// tapRadius: Integer
// Valid tap radius from previous touch point
tapRadius: 10,
press: function(/*Object*/data, /*Event*/e){
// summary:
// Overwritten, record initial tap info and register a timeout checker for 'tap.hold'
if(e.touches && e.touches.length >= 2){
//tap gesture is only for single touch
delete data.context;
return;
}
var target = e.target;
this._initTap(data, e);
data.tapTimeOut = setTimeout(lang.hitch(this, function(){
if(this._isTap(data, e)){
this.fire(target, {type: "tap.hold"});
}
delete data.context;
}), this.holdThreshold);
},
release: function(/*Object*/data, /*Event*/e){
// summary:
// Overwritten, fire matched 'tap' or 'tap.doubletap' during touchend
if(!data.context){
clearTimeout(data.tapTimeOut);
return;
}
if(this._isTap(data, e)){
switch(data.context.c){
case 1:
this.fire(e.target, {type: "tap"});
break;
case 2:
this.fire(e.target, {type: "tap.doubletap"});
break;
}
}
clearTimeout(data.tapTimeOut);
},
_initTap: function(/*Object*/data, /*Event*/e){
// summary:
// Update the gesture data with new tap info
if(!data.context){
data.context = {x: 0, y: 0, t: 0, c: 0};
}
var ct = new Date().getTime();
if(ct - data.context.t <= this.doubleTapTimeout){
data.context.c++;
}else{
data.context.c = 1;
data.context.x = e.screenX;
data.context.y = e.screenY;
}
data.context.t = ct;
},
_isTap: function(/*Object*/data, /*Event*/e){
// summary:
// Check whether it's an valid tap
var dx = Math.abs(data.context.x - e.screenX);
var dy = Math.abs(data.context.y - e.screenY);
return dx <= this.tapRadius && dy <= this.tapRadius;
}
});
// the default tap instance for handy use
dojox.gesture.tap = new clz();
// Class for creating a new Tap instance
dojox.gesture.tap.Tap = clz;
return dojox.gesture.tap;
});
|
