author | Art Barstow <art.barstow@nokia.com> |
Sun, 20 Jan 2013 19:59:00 -0500 | |
branch | v1 |
changeset 175 | b38f9bc75738 |
parent 174 | 4d68f6253520 |
child 176 | b92906399c82 |
permissions | -rw-r--r-- |
4 | 1 |
<!DOCTYPE html> |
74
b1920268c222
Add language and viewport metadata.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
73
diff
changeset
|
2 |
<html lang="en"> |
4 | 3 |
<head> |
101
2d830a098494
Initial checkin for Touch Events version 1
Matt Brubeck <mbrubeck@mozilla.com>
parents:
100
diff
changeset
|
4 |
<title>Touch Events version 1</title> |
4 | 5 |
<meta http-equiv='Content-Type' content='text/html;charset=utf-8'/> |
74
b1920268c222
Add language and viewport metadata.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
73
diff
changeset
|
6 |
<meta name="viewport" content="width=device-width"> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
7 |
<!-- |
4 | 8 |
=== NOTA BENE === |
9 |
For the three scripts below, if your spec resides on dev.w3 you can check them |
|
10 |
out in the same tree and use relative links so that they'll work offline, |
|
11 |
--> |
|
170
15689c78573b
Update URL of respec per recommendation from Marcos
Art Barstow <art.barstow@nokia.com>
parents:
169
diff
changeset
|
12 |
<script src='//www.w3.org/Tools/respec/respec-w3c-common' class='remove'></script> |
4 | 13 |
<script class='remove'> |
14 |
var respecConfig = { |
|
15 |
// specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED. |
|
168
3c071d7f7be6
Update boilerplate for LC#2 on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
144
diff
changeset
|
16 |
specStatus: "LCWD", |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
17 |
|
4 | 18 |
// the specification's short name, as in http://www.w3.org/TR/short-name/ |
19 |
shortName: "touch-events", |
|
20 |
||
21 |
// if your specification has a subtitle that goes below the main |
|
22 |
// formal title, define it here |
|
23 |
// subtitle : "an excellent document", |
|
24 |
||
25 |
// if you wish the publication date to be other than today, set this |
|
168
3c071d7f7be6
Update boilerplate for LC#2 on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
144
diff
changeset
|
26 |
publishDate: "2013-01-24", |
4 | 27 |
|
28 |
// if the specification's copyright date is a range of years, specify |
|
29 |
// the start date here: |
|
30 |
// copyrightStart: "2005" |
|
31 |
||
32 |
// if there is a previously published draft, uncomment this and set its YYYY-MM-DD date |
|
33 |
// and its maturity status |
|
168
3c071d7f7be6
Update boilerplate for LC#2 on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
144
diff
changeset
|
34 |
previousPublishDate: "2011-12-15", |
3c071d7f7be6
Update boilerplate for LC#2 on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
144
diff
changeset
|
35 |
previousMaturity: "CR", |
4 | 36 |
|
37 |
// if there a publicly available Editor's Draft, this is the link |
|
107
923f5ba58a22
v1 spec should link to v1 editors' draft.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
106
diff
changeset
|
38 |
edDraftURI: "http://dvcs.w3.org/hg/webevents/raw-file/v1/touchevents.html", |
4 | 39 |
|
40 |
// if this is a LCWD, uncomment and set the end of its review period |
|
168
3c071d7f7be6
Update boilerplate for LC#2 on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
144
diff
changeset
|
41 |
lcEnd: "2013-02-14", |
3c071d7f7be6
Update boilerplate for LC#2 on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
144
diff
changeset
|
42 |
//crEnd: "2012-03-15", |
4 | 43 |
|
44 |
// if you want to have extra CSS, append them to this list |
|
45 |
// it is recommended that the respec.css stylesheet be kept |
|
8
3349d49e5f46
added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents:
7
diff
changeset
|
46 |
extraCSS: ["http://www.w3.org/StyleSheets/TR/W3C-TR.css", "http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css"], |
4 | 47 |
|
48 |
// editors, add as many as you like |
|
49 |
// only "name" is required |
|
50 |
editors: [ |
|
51 |
{ name: "Doug Schepers", url: "http://schepers.cc/", |
|
52 |
company: "W3C", companyURL: "http://w3.org/" }, |
|
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
53 |
{ name: "Sangwhan Moon", |
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
54 |
company: "Opera Software ASA", companyURL: "http://www.opera.com/" }, |
97
3f54db94ae0d
ISSUE-3: Click events should be dispatched after any touch events are processed.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
96
diff
changeset
|
55 |
{ name: "Matt Brubeck", url: "http://limpet.net/mbrubeck/", |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
56 |
company: "Mozilla", companyURL: "http://www.mozilla.org/" }, |
4 | 57 |
], |
58 |
||
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
59 |
// authors, add as many as you like. |
4 | 60 |
// This is optional, uncomment if you have authors as well as editors. |
61 |
// only "name" is required. Same format as editors. |
|
62 |
||
63 |
//authors: [ |
|
64 |
// { name: "Your Name", url: "http://example.org/", |
|
65 |
// company: "Your Company", companyURL: "http://example.com/" }, |
|
66 |
//], |
|
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
67 |
|
4 | 68 |
// name of the WG |
69 |
wg: "Web Events Working Group", |
|
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
70 |
|
4 | 71 |
// URI of the public WG page |
72 |
wgURI: "http://www.w3.org/2010/webevents/", |
|
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
73 |
|
4 | 74 |
// name (with the @w3c.org) of the public mailing to which comments are due |
75 |
wgPublicList: "public-webevents", |
|
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
76 |
|
4 | 77 |
// URI of the patent status for this WG, for Rec-track documents |
78 |
// !!!! IMPORTANT !!!! |
|
79 |
// This is important for Rec-track documents, do not copy a patent URI from a random |
|
80 |
// document unless you know what you're doing. If in doubt ask your friendly neighbourhood |
|
81 |
// Team Contact. |
|
82 |
wgPatentURI: "http://www.w3.org/2004/01/pp-impl/45559/status", |
|
83 |
}; |
|
84 |
</script> |
|
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
85 |
|
66
9555f231576e
Fix another validation error.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
61
diff
changeset
|
86 |
<style type="text/css"> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
87 |
.event { |
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
88 |
font-family: monospace; |
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
89 |
color: #459900; |
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
90 |
} |
23
4958878564b1
ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
22
diff
changeset
|
91 |
|
4958878564b1
ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
22
diff
changeset
|
92 |
pre.idl { |
4958878564b1
ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
22
diff
changeset
|
93 |
white-space: pre-wrap; |
4958878564b1
ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
22
diff
changeset
|
94 |
} |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
95 |
</style> |
4 | 96 |
</head> |
97 |
<body> |
|
130
80a03ddfb79b
updates for 27-Oct-2011 LCWD
Art Barstow <art.barstow@nokia.com>
parents:
126
diff
changeset
|
98 |
<section id='sotd'> |
171
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
99 |
This specification is the 24 January 2013 Last Call Working Draft. |
175
b38f9bc75738
Updated spec per proposal in http://lists.w3.org/Archives/Public/public-webevents/2013JanMar/0027.html
Art Barstow <art.barstow@nokia.com>
parents:
174
diff
changeset
|
100 |
The comment period for this Last Call Working Draft ends 14 February 2013. |
143
5bbc6e212756
Updates for publishing as a Candidate Recommendation
Art Barstow <art.barstow@nokia.com>
parents:
142
diff
changeset
|
101 |
|
171
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
102 |
The <a href="http://www.w3.org/TR/2011/CR-touch-events-20111215/"> |
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
103 |
15 December 2011 Candidate Recommendation</a> |
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
104 |
was returned to Last Call Working Draft because of |
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
105 |
<a href="https://www.w3.org/2010/webevents/track/">issues</a> |
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
106 |
found during the implementation and interoperability testing phases. |
144 | 107 |
|
171
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
108 |
The WG will complete its |
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
109 |
<a href="http://w3c-test.org/webevents/tests/touch-events-v1/">test suite</a> |
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
110 |
and two or more independent implementations must pass each test before |
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
111 |
the specification is published as a Proposed Recommendation. |
2eef5f6edd35
Update Staus section for LCWD pub on 24-Jan-2013
Art Barstow <art.barstow@nokia.com>
parents:
170
diff
changeset
|
112 |
The group will also create an Implementation Report. |
130
80a03ddfb79b
updates for 27-Oct-2011 LCWD
Art Barstow <art.barstow@nokia.com>
parents:
126
diff
changeset
|
113 |
</section> |
80a03ddfb79b
updates for 27-Oct-2011 LCWD
Art Barstow <art.barstow@nokia.com>
parents:
126
diff
changeset
|
114 |
|
4 | 115 |
<section id='abstract'> |
103 | 116 |
The Touch Events specification defines a set of low-level events that |
85 | 117 |
represent one or more points of contact with a touch-sensitive surface, |
118 |
and changes of those points with respect to the surface and any DOM |
|
119 |
elements displayed upon it (e.g. for touch screens) or associated with it |
|
120 |
(e.g. for drawing tablets without displays). It also addresses |
|
121 |
pen-tablet devices, such as drawing tablets, with consideration toward |
|
122 |
stylus capabilities. |
|
4 | 123 |
</section> |
5 | 124 |
|
81
e5b2d26a6892
Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents:
80
diff
changeset
|
125 |
<section id='introduction' class='informative'> |
e5b2d26a6892
Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents:
80
diff
changeset
|
126 |
<h2>Introduction</h2> |
e5b2d26a6892
Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents:
80
diff
changeset
|
127 |
|
85 | 128 |
<p> |
129 |
User Agents that run on terminals which provide touch input to use web |
|
87 | 130 |
applications typically use interpreted mouse events to allow users |
85 | 131 |
to access interactive web applications. However, these interpreted |
132 |
events, being normalized data based on the physical touch input, tend |
|
87 | 133 |
to have limitations on delivering the intended user experience. |
85 | 134 |
Additionally, it is not possible to handle concurrent input regardless |
87 | 135 |
of device capability, due to constraints of mouse events: both |
136 |
system level limitations and legacy compatibility. |
|
85 | 137 |
</p> |
81
e5b2d26a6892
Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents:
80
diff
changeset
|
138 |
|
85 | 139 |
<p> |
140 |
Meanwhile, native applications are capable of handling both cases with |
|
141 |
the provided system APIs. |
|
142 |
</p> |
|
143 |
||
144 |
<p> |
|
145 |
The Touch Events specification provides a solution to this problem by |
|
86 | 146 |
specifying interfaces to allow web applications to directly handle touch |
85 | 147 |
events, and multiple touch points for capable devices. |
148 |
</p> |
|
81
e5b2d26a6892
Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents:
80
diff
changeset
|
149 |
</section> |
e5b2d26a6892
Corrected changes clobbered due to mistake
Sangwhan Moon <smoon@opera.com>
parents:
80
diff
changeset
|
150 |
|
28
4cbcb68446b5
First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents:
27
diff
changeset
|
151 |
<section id='conformance'> |
85 | 152 |
<p> |
153 |
This specification defines conformance criteria that apply to a single |
|
154 |
product: the <dfn id="dfn-user-agent">user agent</dfn> that implements |
|
155 |
the interfaces that it contains. |
|
156 |
</p> |
|
28
4cbcb68446b5
First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents:
27
diff
changeset
|
157 |
|
85 | 158 |
<p> |
159 |
Implementations that use ECMAScript to implement the APIs defined in |
|
160 |
this specification must implement them in a manner consistent with the |
|
161 |
ECMAScript Bindings defined in the Web IDL specification [[!WEBIDL]] as |
|
162 |
this specification uses that specification and terminology. |
|
163 |
</p> |
|
28
4cbcb68446b5
First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents:
27
diff
changeset
|
164 |
|
85 | 165 |
<p> |
166 |
A conforming implementation is required to implement all fields |
|
167 |
defined in this specification. |
|
168 |
</p> |
|
28
4cbcb68446b5
First draft of a Conformance section based on the DAP WG's Contacts API:
Art Barstow <art.barstow@nokia.com>
parents:
27
diff
changeset
|
169 |
</section> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
170 |
|
4 | 171 |
<section> |
46
e761aa494278
ISSUE-11: Rename TouchPoint to Touch
Matt Brubeck <mbrubeck@mozilla.com>
parents:
45
diff
changeset
|
172 |
<h2><a>Touch</a> Interface</h2> |
85 | 173 |
<p> |
139
f9d12da970bf
Restore missing Touch.target attribute (LC-1).
Matt Brubeck <mbrubeck@mozilla.com>
parents:
131
diff
changeset
|
174 |
This interface describes an individual <a>touch point</a> for a touch |
106
ede041c4799e
Issue-16: Specify that Touch/TouchList/TouchEvent objects are immutable.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
104
diff
changeset
|
175 |
event. <a>Touch</a> objects are immutable; after one is created, its |
ede041c4799e
Issue-16: Specify that Touch/TouchList/TouchEvent objects are immutable.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
104
diff
changeset
|
176 |
attributes must not change. |
85 | 177 |
</p> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
178 |
|
46
e761aa494278
ISSUE-11: Rename TouchPoint to Touch
Matt Brubeck <mbrubeck@mozilla.com>
parents:
45
diff
changeset
|
179 |
<dl title='interface Touch' class='idl'> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
180 |
<dt>readonly attribute long identifier</dt> |
5 | 181 |
<dd> |
91
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
182 |
An identification number for each <a>touch point</a>. |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
183 |
|
91
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
184 |
When a touch point becomes active, it must be assigned an |
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
185 |
<a>identifier</a> that is distinct from any other <a>active touch |
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
186 |
point</a>. While the touch point remains active, all events that |
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
187 |
refer to it must assign it the same <a>identifier</a>. |
5 | 188 |
</dd> |
4 | 189 |
|
139
f9d12da970bf
Restore missing Touch.target attribute (LC-1).
Matt Brubeck <mbrubeck@mozilla.com>
parents:
131
diff
changeset
|
190 |
<dt>readonly attribute EventTarget target</dt> |
f9d12da970bf
Restore missing Touch.target attribute (LC-1).
Matt Brubeck <mbrubeck@mozilla.com>
parents:
131
diff
changeset
|
191 |
<dd> |
f9d12da970bf
Restore missing Touch.target attribute (LC-1).
Matt Brubeck <mbrubeck@mozilla.com>
parents:
131
diff
changeset
|
192 |
The <a>Element</a> on which the <a>touch point</a> started when it |
f9d12da970bf
Restore missing Touch.target attribute (LC-1).
Matt Brubeck <mbrubeck@mozilla.com>
parents:
131
diff
changeset
|
193 |
was first placed on the surface, even if the <a>touch point</a> has |
f9d12da970bf
Restore missing Touch.target attribute (LC-1).
Matt Brubeck <mbrubeck@mozilla.com>
parents:
131
diff
changeset
|
194 |
since moved outside the interactive area of that element. |
f9d12da970bf
Restore missing Touch.target attribute (LC-1).
Matt Brubeck <mbrubeck@mozilla.com>
parents:
131
diff
changeset
|
195 |
</dd> |
f9d12da970bf
Restore missing Touch.target attribute (LC-1).
Matt Brubeck <mbrubeck@mozilla.com>
parents:
131
diff
changeset
|
196 |
|
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
197 |
<dt>readonly attribute long screenX</dt> |
5 | 198 |
<dd> |
123
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
199 |
The horizontal coordinate of point relative to the screen in pixels |
5 | 200 |
</dd> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
201 |
<dt>readonly attribute long screenY</dt> |
5 | 202 |
<dd> |
123
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
203 |
The vertical coordinate of point relative to the screen in pixels |
5 | 204 |
</dd> |
4 | 205 |
|
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
206 |
<dt>readonly attribute long clientX</dt> |
5 | 207 |
<dd> |
123
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
208 |
The horizontal coordinate of point relative to the viewport in pixels, |
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
209 |
excluding any scroll offset |
5 | 210 |
</dd> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
211 |
<dt>readonly attribute long clientY</dt> |
5 | 212 |
<dd> |
123
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
213 |
The vertical coordinate of point relative to the viewport in pixels, |
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
214 |
excluding any scroll offset |
5 | 215 |
</dd> |
216 |
||
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
217 |
<dt>readonly attribute long pageX</dt> |
5 | 218 |
<dd> |
123
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
219 |
The horizontal coordinate of point relative to the viewport in pixels, |
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
220 |
including any scroll offset |
5 | 221 |
</dd> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
222 |
<dt>readonly attribute long pageY</dt> |
5 | 223 |
<dd> |
123
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
224 |
The vertical coordinate of point relative to the viewport in pixels, |
bee004414dba
ACTION-81 - Minor editorial changes, added units for properties in Touch interface
Sangwhan Moon <smoon@opera.com>
parents:
121
diff
changeset
|
225 |
including any scroll offset |
5 | 226 |
</dd> |
227 |
</dl> |
|
228 |
</section> |
|
229 |
||
230 |
<section> |
|
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
231 |
<h2><a>TouchList</a> Interface</h2> |
85 | 232 |
<p> |
233 |
This interface defines a list of individual points of contact for a |
|
106
ede041c4799e
Issue-16: Specify that Touch/TouchList/TouchEvent objects are immutable.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
104
diff
changeset
|
234 |
touch event. <a>TouchList</a> objects are immutable; after one is |
ede041c4799e
Issue-16: Specify that Touch/TouchList/TouchEvent objects are immutable.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
104
diff
changeset
|
235 |
created, its contents must not change. |
85 | 236 |
</p> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
237 |
|
5 | 238 |
<dl title='interface TouchList' class='idl'> |
239 |
<dt>readonly attribute unsigned long length</dt> |
|
240 |
<dd> |
|
47
926af59e3515
Fix typos in previous commit
Matt Brubeck <mbrubeck@mozilla.com>
parents:
46
diff
changeset
|
241 |
returns the number of <a>Touch</a>es in the list |
5 | 242 |
</dd> |
103 | 243 |
<dt>getter <a>Touch</a> item (in unsigned long index)</dt> |
5 | 244 |
<dd> |
103 | 245 |
returns the <a>Touch</a> at the specified index in the list |
5 | 246 |
</dd> |
247 |
</dl> |
|
248 |
</section> |
|
249 |
||
250 |
<section> |
|
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
251 |
<h2><a>TouchEvent</a> Interface</h2> |
85 | 252 |
<p> |
253 |
This interface defines the <a>touchstart</a>, <a>touchend</a>, |
|
101
2d830a098494
Initial checkin for Touch Events version 1
Matt Brubeck <mbrubeck@mozilla.com>
parents:
100
diff
changeset
|
254 |
<a>touchmove</a>, and <a>touchcancel</a> event types. |
106
ede041c4799e
Issue-16: Specify that Touch/TouchList/TouchEvent objects are immutable.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
104
diff
changeset
|
255 |
<a>TouchEvent</a> objects are immutable; after one is created and |
ede041c4799e
Issue-16: Specify that Touch/TouchList/TouchEvent objects are immutable.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
104
diff
changeset
|
256 |
initialized, its attributes must not change. |
85 | 257 |
</p> |
5 | 258 |
|
6
83ce29dff849
changed cx/cy to rx/ry, defined units for both; added key modifier attributes; changed identifier to float
shepazu <schepers@w3.org>
parents:
5
diff
changeset
|
259 |
<dl title='interface TouchEvent : UIEvent' class='idl'> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
260 |
<dt>readonly attribute <a>TouchList</a> touches</dt> |
4 | 261 |
<dd> |
85 | 262 |
a list of <a>Touch</a>es for every point of contact currently |
99 | 263 |
touching the surface. |
4 | 264 |
</dd> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
265 |
<dt>readonly attribute <a>TouchList</a> targetTouches</dt> |
4 | 266 |
<dd> |
96
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
267 |
a list of <a>Touch</a>es for every point of contact that is touching |
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
268 |
the surface <em>and</em> started on the element that is the |
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
269 |
<a>target</a> of the current event. |
4 | 270 |
</dd> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
271 |
<dt>readonly attribute <a>TouchList</a> changedTouches</dt> |
4 | 272 |
<dd> |
96
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
273 |
<p> |
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
274 |
a list of <a>Touch</a>es for every point of contact which contributed |
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
275 |
to the event. |
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
276 |
</p> |
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
277 |
<p> |
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
278 |
For the <a>touchstart</a> event this must be a list of the touch |
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
279 |
points that just became active with the current event. For the |
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
280 |
<a>touchmove</a> event this must be a list of the touch points that |
121
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
281 |
have moved since the last event. For the <a>touchend</a> and |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
282 |
<a>touchcancel</a> events this must be a list of the touch points |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
283 |
that have just been removed from the surface. |
96
457c2df41b66
Add some more details about the targetTouches and changedTouches attributes.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
95
diff
changeset
|
284 |
</p> |
4 | 285 |
</dd> |
23
4958878564b1
ISSUE-8: Add an initTouchEvent method.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
22
diff
changeset
|
286 |
|
30
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
287 |
<dt>readonly attribute boolean altKey</dt> |
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
288 |
<dd> |
85 | 289 |
<code>true</code> if the alt (Alternate) key modifier is activated; |
290 |
otherwise <code>false</code> |
|
30
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
291 |
</dd> |
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
292 |
<dt>readonly attribute boolean metaKey</dt> |
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
293 |
<dd> |
85 | 294 |
<code>true</code> if the meta (Meta) key modifier is activated; |
295 |
otherwise <code>false</code>. On some platforms this attribute may |
|
296 |
map to a differently-named key modifier. |
|
30
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
297 |
</dd> |
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
298 |
<dt>readonly attribute boolean ctrlKey</dt> |
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
299 |
<dd> |
85 | 300 |
<code>true</code> if the ctrl (Control) key modifier is activated; |
301 |
otherwise <code>false</code> |
|
30
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
302 |
</dd> |
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
303 |
<dt>readonly attribute boolean shiftKey</dt> |
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
304 |
<dd> |
85 | 305 |
<code>true</code> if the shift (Shift) key modifier is activated; |
306 |
otherwise <code>false</code> |
|
30
795c0f6c44e7
ISSUE-12: altKey/ctrlKey/etc. should be attributes of TouchEvent, not TouchPoint
Matt Brubeck <mbrubeck@mozilla.com>
parents:
29
diff
changeset
|
307 |
</dd> |
4 | 308 |
</dl> |
100
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
309 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
310 |
<section class="informative"> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
311 |
<h2>Usage Examples</h2> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
312 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
313 |
<p> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
314 |
The examples below demonstrate the relations between the different |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
315 |
<a>TouchList</a> members defined in a <a>TouchEvent</a>. |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
316 |
</p> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
317 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
318 |
<section> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
319 |
<h3>touches and targetTouches of a <a>TouchEvent</a></h3> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
320 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
321 |
<p> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
322 |
This example demonstrates the utility and relations between the |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
323 |
touches and targetTouches members defined in the <a>TouchEvent</a> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
324 |
interface. The following code will generate different output based |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
325 |
on the number of touch points on the touchable element and the document: |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
326 |
</p> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
327 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
328 |
<pre class="example"> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
329 |
<div id='touchable'> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
330 |
This element is touchable. |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
331 |
</div> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
332 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
333 |
document.getElementById('touchable').addEventListener('touchstart', function(ev) { |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
334 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
335 |
if (ev.touches.item(0) == ev.targetTouches.item(0)) |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
336 |
{ |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
337 |
/** |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
338 |
* If the first touch on the surface is also targeting the |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
339 |
* "touchable" element, the code below should execute. |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
340 |
* Since targetTouches is a subset of touches which covers the |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
341 |
* entire surface, TouchEvent.touches >= TouchEvents.targetTouches |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
342 |
* is always true. |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
343 |
*/ |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
344 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
345 |
document.write('Hello Touch Events!'); |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
346 |
} |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
347 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
348 |
if (ev.touches.length == ev.targetTouches.length) |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
349 |
{ |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
350 |
/** |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
351 |
* If all of the active touch points are on the "touchable" |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
352 |
* element, the length properties should be the same. |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
353 |
*/ |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
354 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
355 |
document.write('All points are on target element') |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
356 |
} |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
357 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
358 |
if (ev.touches.length > 1) |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
359 |
{ |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
360 |
/** |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
361 |
* On a single touch input device, there can only be one point |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
362 |
* of contact on the surface, so the following code can only |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
363 |
* execute when the terminal supports multiple touches. |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
364 |
*/ |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
365 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
366 |
document.write('Hello Multiple Touch!'); |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
367 |
} |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
368 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
369 |
}, false); |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
370 |
</pre> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
371 |
</section> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
372 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
373 |
<section> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
374 |
<h3>changedTouches of a <a>TouchEvent</a></h3> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
375 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
376 |
<p> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
377 |
This example demonstrates the utility of changedTouches and it's relation |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
378 |
with the other <a>TouchList</a> members of the <a>TouchEvent</a> interface. |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
379 |
The code is a example which triggers whenever a touch point is removed |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
380 |
from the defined touchable element: |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
381 |
</p> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
382 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
383 |
<pre class="example"> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
384 |
<div id='touchable'> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
385 |
This element is touchable. |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
386 |
</div> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
387 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
388 |
document.getElementById('touchable').addEventListener('touchend', function(ev) { |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
389 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
390 |
/** |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
391 |
* Example output when three touch points are on the surface, |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
392 |
* two of them being on the "touchable" element and one point |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
393 |
* in the "touchable" element is lifted from the surface: |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
394 |
* |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
395 |
* Touch points removed: 1 |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
396 |
* Touch points left on element: 1 |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
397 |
* Touch points left on document: 2 |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
398 |
*/ |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
399 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
400 |
document.write('Removed: ' + ev.changedTouches.length); |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
401 |
document.write('Remaining on element: ' + ev.targetTouches.length); |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
402 |
document.write('Remaining on document: ' + ev.touches.length); |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
403 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
404 |
}, false); |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
405 |
</pre> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
406 |
</section> |
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
407 |
|
4bbe000815dd
Initial work for Issue-18 - may need some clean-up
Sangwhan Moon <smoon@opera.com>
parents:
99
diff
changeset
|
408 |
</section> |
8
3349d49e5f46
added force attribute; added issues around InkML, units, preventDefault(), timestamp
shepazu <schepers@w3.org>
parents:
7
diff
changeset
|
409 |
|
126
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
410 |
<section class="informative"> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
411 |
<h2>List of <a>TouchEvent</a> types</h2> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
412 |
|
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
413 |
<p> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
414 |
The following table provides a summary of the types of possible |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
415 |
<a>TouchEvent</a> types defined in this specification. All events |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
416 |
should accomplish the bubbling phase. Some events are not cancelable |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
417 |
(see <a>preventDefault</a>). |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
418 |
</p> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
419 |
|
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
420 |
<!-- |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
421 |
// FIXME: As of the time of writing, respec.js doesn't have support for |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
422 |
// tables like this - we're just piggybacking on a existing class, with |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
423 |
// raw markup as a quick and dirty workaround. |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
424 |
--> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
425 |
|
130
80a03ddfb79b
updates for 27-Oct-2011 LCWD
Art Barstow <art.barstow@nokia.com>
parents:
126
diff
changeset
|
426 |
<table class="parameters" id="table-event-summary"> |
126
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
427 |
<tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
428 |
<th>Event Type</th> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
429 |
<th>Sync / Async</th> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
430 |
<th>Bubbling phase</th> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
431 |
<th>Trusted proximal event target types</th> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
432 |
<th>DOM interface</th> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
433 |
<th>Cancelable</th> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
434 |
<th>Default Action</th> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
435 |
</tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
436 |
<tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
437 |
<td><a>touchstart</a></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
438 |
<td>Sync</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
439 |
<td>Yes</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
440 |
<td><code>Document, Element</code></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
441 |
<td><a>TouchEvent</a></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
442 |
<td>Yes</td> |
131
a057d31f3cc6
Change default action for touchstart and touchmove from none to undefined.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
130
diff
changeset
|
443 |
<td>undefined</td> |
126
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
444 |
</tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
445 |
<tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
446 |
<td><a>touchend</a></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
447 |
<td>Sync</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
448 |
<td>Yes</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
449 |
<td><code>Document, Element</code></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
450 |
<td><a>TouchEvent</a></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
451 |
<td>Yes</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
452 |
<td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
453 |
Varies: mousemove (If point has been moved), mousedown, |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
454 |
mouseup, click |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
455 |
</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
456 |
</tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
457 |
<tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
458 |
<td><a>touchmove</a></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
459 |
<td>Sync</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
460 |
<td>Yes</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
461 |
<td><code>Document, Element</code></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
462 |
<td><a>TouchEvent</a></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
463 |
<td>Yes</td> |
131
a057d31f3cc6
Change default action for touchstart and touchmove from none to undefined.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
130
diff
changeset
|
464 |
<td>undefined</td> |
126
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
465 |
</tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
466 |
<tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
467 |
<td><a>touchcancel</a></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
468 |
<td>Sync</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
469 |
<td>Yes</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
470 |
<td><code>Document, Element</code></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
471 |
<td><a>TouchEvent</a></td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
472 |
<td>No</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
473 |
<td>none</td> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
474 |
</tr> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
475 |
</table> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
476 |
</section> |
121689c8a8f9
Add a single table describing all TouchEvents. Addresses ACTION-83, as a part of LC-5.
Sangwhan Moon <smoon@opera.com>
parents:
124
diff
changeset
|
477 |
|
5 | 478 |
<section> |
85 | 479 |
<h3 id="event-touchstart">The <dfn class="event">touchstart</dfn> |
480 |
event</h3> |
|
481 |
<p> |
|
482 |
A user agent must dispatch this event type to indicate when the user |
|
483 |
places a <a>touch point</a> on the touch surface. |
|
484 |
</p> |
|
55
7df98116715b
Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
54
diff
changeset
|
485 |
|
85 | 486 |
<p> |
93
29ec4253b862
Issue-6: Events should be dispatched to targets within frames.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
92
diff
changeset
|
487 |
The target of this event must be an <a>Element</a>. If the touch |
29ec4253b862
Issue-6: Events should be dispatched to targets within frames.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
92
diff
changeset
|
488 |
point is within a frame, the event should be dispatched to an element |
29ec4253b862
Issue-6: Events should be dispatched to targets within frames.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
92
diff
changeset
|
489 |
in the <a>child browsing context</a> of that frame. |
85 | 490 |
</p> |
95
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
491 |
|
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
492 |
<p> |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
493 |
If the <a>preventDefault</a> method is called on this event, it |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
494 |
should prevent any default actions caused by any touch events |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
495 |
associated with the same <a>active touch point</a>, including mouse |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
496 |
events or scrolling. |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
497 |
</p> |
5 | 498 |
</section> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
499 |
|
5 | 500 |
<section> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
501 |
<h3 id="event-touchend">The <dfn class="event">touchend</dfn> event</h3> |
85 | 502 |
<p> |
503 |
A user agent must dispatch this event type to indicate when the user |
|
504 |
removes a <a>touch point</a> from the touch surface, also including |
|
505 |
cases where the touch point physically leaves the touch surface, such |
|
506 |
as being dragged off of the screen. |
|
507 |
</p> |
|
54
be35b766b5ef
Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
53
diff
changeset
|
508 |
|
85 | 509 |
<p> |
121
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
510 |
The <a>target</a> of this event must be the same <a>Element</a> on |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
511 |
which the <a>touch point</a> started when it was first |
85 | 512 |
placed on the surface, even if the <a>touch point</a> has since moved |
513 |
outside the interactive area of the <a>target</a> element. |
|
514 |
</p> |
|
55
7df98116715b
Clarify targeting of touchmove and touchend events, and add tests.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
54
diff
changeset
|
515 |
|
85 | 516 |
<p> |
517 |
The <a>touch point</a> or points that were removed must be included |
|
518 |
in the <a>changedTouches</a> attribute of the <a>TouchEvent</a>, and |
|
519 |
must not be included in the <a>touches</a> and <a>targetTouches</a> |
|
520 |
attributes. |
|
521 |
</p> |
|
5 | 522 |
</section> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
523 |
|
5 | 524 |
<section> |
9
8171bbe11ccc
changed floats to longs; clarified definitions; added editors Moon, Brubeck; tidied ReSpec code; fixed credits; revised touchcancel event
shepazu <schepers@w3.org>
parents:
8
diff
changeset
|
525 |
<h3 id="event-touchmove">The <dfn class="event">touchmove</dfn> event</h3> |
85 | 526 |
<p> |
527 |
A user agent must dispatch this event type to indicate when the user |
|
528 |
moves a <a>touch point</a> along the touch surface. |
|
529 |
</p> |
|
54
be35b766b5ef
Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
53
diff
changeset
|
530 |
|
85 | 531 |
<p> |
121
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
532 |
The <a>target</a> of this event must be the same <a>Element</a> on |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
533 |
which the <a>touch point</a> started when it was first |
85 | 534 |
placed on the surface, even if the <a>touch point</a> has since moved |
535 |
outside the interactive area of the <a>target</a> element. |
|
536 |
</p> |
|
54
be35b766b5ef
Wrap some text to 80 characters.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
53
diff
changeset
|
537 |
|
85 | 538 |
<p> |
539 |
Note that the rate at which the user agent sends <a>touchmove</a> |
|
540 |
events is implementation-defined, and may depend on hardware |
|
541 |
capabilities and other implementation details. |
|
542 |
</p> |
|
95
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
543 |
|
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
544 |
<p> |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
545 |
If the <a>preventDefault</a> method is called on the <em>first</em> |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
546 |
<a>touchmove</a> event of an <a>active touch point</a>, it should |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
547 |
prevent any default action caused by any <a>touchmove</a> event |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
548 |
associated with the same <a>active touch point</a>, such as scrolling. |
80bd73a2e5b2
preventDefault recommendations for touchstart/touchmove and scrolling.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
94
diff
changeset
|
549 |
</p> |
5 | 550 |
</section> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
551 |
|
5 | 552 |
<section> |
61 | 553 |
<h3 id="event-touchcancel">The <dfn class="event">touchcancel</dfn> event</h3> |
85 | 554 |
<p> |
555 |
A user agent must dispatch this event type to indicate when a touch |
|
556 |
point has been disrupted in an implementation-specific manner, such as |
|
557 |
a synchronous event or action originating from the UA canceling the |
|
558 |
touch, or the touch point leaving the document window into a |
|
559 |
non-document area which is capable of handling user interactions. |
|
560 |
(e.g. The UA's native user interface, plug-ins) A user agent may |
|
561 |
also dispatch this event type when the user places more <a>touch |
|
562 |
point</a>s on the touch surface than the device or implementation is |
|
563 |
configured to store, in which case the earliest <a>Touch</a> object |
|
564 |
in the <a>TouchList</a> should be removed. |
|
565 |
</p> |
|
121
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
566 |
|
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
567 |
<p> |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
568 |
The <a>target</a> of this event must be the same <a>Element</a> on |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
569 |
which the <a>touch point</a> started when it was first |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
570 |
placed on the surface, even if the <a>touch point</a> has since moved |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
571 |
outside the interactive area of the <a>target</a> element. |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
572 |
</p> |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
573 |
|
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
574 |
<p> |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
575 |
The <a>touch point</a> or points that were removed must be included |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
576 |
in the <a>changedTouches</a> attribute of the <a>TouchEvent</a>, and |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
577 |
must not be included in the <a>touches</a> and <a>targetTouches</a> |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
578 |
attributes. |
df403a9b8ba6
Addressed ISSUE-21 and ISSUE-22.
Cathy Chan <cathy.chan@nokia.com>
parents:
120
diff
changeset
|
579 |
</p> |
5 | 580 |
</section> |
4 | 581 |
</section> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
582 |
|
68
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
583 |
<section> |
115
a4ba6867d4d0
Extend the Document interface instead of creating a DocumentTouch interface
Matt Brubeck <mbrubeck@mozilla.com>
parents:
107
diff
changeset
|
584 |
<h2>Extensions to the <a>Document</a> Interface</h2> |
85 | 585 |
<p> |
115
a4ba6867d4d0
Extend the Document interface instead of creating a DocumentTouch interface
Matt Brubeck <mbrubeck@mozilla.com>
parents:
107
diff
changeset
|
586 |
The <a>Document</a> interface [[!DOM-LEVEL-3-CORE]] contains methods |
a4ba6867d4d0
Extend the Document interface instead of creating a DocumentTouch interface
Matt Brubeck <mbrubeck@mozilla.com>
parents:
107
diff
changeset
|
587 |
by which the user can create <a>Touch</a> and <a>TouchList</a> |
a4ba6867d4d0
Extend the Document interface instead of creating a DocumentTouch interface
Matt Brubeck <mbrubeck@mozilla.com>
parents:
107
diff
changeset
|
588 |
objects. |
85 | 589 |
</p> |
68
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
590 |
|
115
a4ba6867d4d0
Extend the Document interface instead of creating a DocumentTouch interface
Matt Brubeck <mbrubeck@mozilla.com>
parents:
107
diff
changeset
|
591 |
<dl title='partial interface Document' class='idl'> |
68
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
592 |
<dt>Touch createTouch()</dt> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
593 |
<dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
594 |
Creates a <a>Touch</a> object with the specified attributes. |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
595 |
<dl class='parameters'> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
596 |
<dt>AbstractView view</dt> <dd></dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
597 |
<dt>EventTarget target</dt> <dd></dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
598 |
<dt>long identifier</dt> <dd></dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
599 |
<dt>long pageX</dt> <dd></dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
600 |
<dt>long pageY</dt> <dd></dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
601 |
<dt>long screenX</dt> <dd></dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
602 |
<dt>long screenY</dt> <dd></dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
603 |
</dl> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
604 |
</dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
605 |
|
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
606 |
<dt>TouchList createTouchList()</dt> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
607 |
<dd> |
174
4d68f6253520
Fix description of touches parameter for createTouchList method
Art Barstow <art.barstow@nokia.com>
parents:
173
diff
changeset
|
608 |
Creates a <a>TouchList</a> object consisting of zero or more <a>Touch</a> objects. |
175
b38f9bc75738
Updated spec per proposal in http://lists.w3.org/Archives/Public/public-webevents/2013JanMar/0027.html
Art Barstow <art.barstow@nokia.com>
parents:
174
diff
changeset
|
609 |
Calling this method with no arguments creates a <a>TouchList</a> with no objects in it |
b38f9bc75738
Updated spec per proposal in http://lists.w3.org/Archives/Public/public-webevents/2013JanMar/0027.html
Art Barstow <art.barstow@nokia.com>
parents:
174
diff
changeset
|
610 |
and length 0 (zero). |
68
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
611 |
<dl class='parameters'> |
173
1222a8c45316
Replace 2 createTouchList methods with one variadic method (Issue-27)
Art Barstow <art.barstow@nokia.com>
parents:
172
diff
changeset
|
612 |
<dt>Touch... touches</dt> <dd></dd> |
68
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
613 |
</dl> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
614 |
</dd> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
615 |
</dl> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
616 |
</section> |
e8bb9dc16d4e
Specify createTouch and createTouchList interfaces.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
66
diff
changeset
|
617 |
|
35
8624a3d5cbd7
ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents:
34
diff
changeset
|
618 |
<section id="mouse-events"> |
8624a3d5cbd7
ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents:
34
diff
changeset
|
619 |
<h2>Interaction with Mouse Events</h2> |
85 | 620 |
<p> |
621 |
The user agent may dispatch both touch events and mouse events |
|
622 |
[[!DOM-LEVEL-2-EVENTS]] in response to the same user input. If the |
|
623 |
user agent dispatches both touch events and mouse events in response to |
|
624 |
a single user action, then the <a>touchstart</a> event type must be |
|
625 |
dispatched before any mouse event types for that action. If the |
|
626 |
<a>preventDefault</a> method of <a>touchstart</a> or <a>touchmove</a> |
|
627 |
is called, the user agent should not dispatch any mouse event that |
|
628 |
would be a consequential result of the the prevented touch event. |
|
629 |
</p> |
|
58
22e39e76033e
Specify basic preventDefault behavior.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
57
diff
changeset
|
630 |
|
142
6130d54c79cd
add editorial note requested by PFWG today
Art Barstow <art.barstow@nokia.com>
parents:
139
diff
changeset
|
631 |
<p class="note"> |
6130d54c79cd
add editorial note requested by PFWG today
Art Barstow <art.barstow@nokia.com>
parents:
139
diff
changeset
|
632 |
If a Web application can process touch events, it can intercept them, |
6130d54c79cd
add editorial note requested by PFWG today
Art Barstow <art.barstow@nokia.com>
parents:
139
diff
changeset
|
633 |
and no corresponding mouse events would need to be dispatched by the |
6130d54c79cd
add editorial note requested by PFWG today
Art Barstow <art.barstow@nokia.com>
parents:
139
diff
changeset
|
634 |
user agent. If the Web application is not specifically written for |
6130d54c79cd
add editorial note requested by PFWG today
Art Barstow <art.barstow@nokia.com>
parents:
139
diff
changeset
|
635 |
touch input devices, it can react to the subsequent mouse events instead. |
6130d54c79cd
add editorial note requested by PFWG today
Art Barstow <art.barstow@nokia.com>
parents:
139
diff
changeset
|
636 |
</p> |
6130d54c79cd
add editorial note requested by PFWG today
Art Barstow <art.barstow@nokia.com>
parents:
139
diff
changeset
|
637 |
|
85 | 638 |
<p> |
98
4ad645b57624
More clarification of behavior for mouse events (ISSUE-3)
Matt Brubeck <mbrubeck@mozilla.com>
parents:
97
diff
changeset
|
639 |
If the user agent intreprets a sequence of touch events as a click, |
4ad645b57624
More clarification of behavior for mouse events (ISSUE-3)
Matt Brubeck <mbrubeck@mozilla.com>
parents:
97
diff
changeset
|
640 |
then it should dispatch <a>mousemove</a>, <a>mousedown</a>, |
4ad645b57624
More clarification of behavior for mouse events (ISSUE-3)
Matt Brubeck <mbrubeck@mozilla.com>
parents:
97
diff
changeset
|
641 |
<a>mouseup</a>, and <a>click</a> events (in that order) at the location |
4ad645b57624
More clarification of behavior for mouse events (ISSUE-3)
Matt Brubeck <mbrubeck@mozilla.com>
parents:
97
diff
changeset
|
642 |
of the <a>touchend</a> event for the corresponding touch input. If the |
4ad645b57624
More clarification of behavior for mouse events (ISSUE-3)
Matt Brubeck <mbrubeck@mozilla.com>
parents:
97
diff
changeset
|
643 |
contents of the document have changed during processing of the touch |
4ad645b57624
More clarification of behavior for mouse events (ISSUE-3)
Matt Brubeck <mbrubeck@mozilla.com>
parents:
97
diff
changeset
|
644 |
events, then the user agent may dispatch the mouse events to a |
4ad645b57624
More clarification of behavior for mouse events (ISSUE-3)
Matt Brubeck <mbrubeck@mozilla.com>
parents:
97
diff
changeset
|
645 |
different target than the touch events. |
97
3f54db94ae0d
ISSUE-3: Click events should be dispatched after any touch events are processed.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
96
diff
changeset
|
646 |
</p> |
3f54db94ae0d
ISSUE-3: Click events should be dispatched after any touch events are processed.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
96
diff
changeset
|
647 |
|
3f54db94ae0d
ISSUE-3: Click events should be dispatched after any touch events are processed.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
96
diff
changeset
|
648 |
<p> |
85 | 649 |
The default actions and ordering of any further touch and mouse events |
650 |
are implementation-defined, except as specified elsewhere. |
|
651 |
</p> |
|
35
8624a3d5cbd7
ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents:
34
diff
changeset
|
652 |
</section> |
8624a3d5cbd7
ISSUE-9: Interaction of touch events and mouse events
Matt Brubeck <mbrubeck@mozilla.com>
parents:
34
diff
changeset
|
653 |
|
10
bad00fb0d663
added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents:
9
diff
changeset
|
654 |
<section> |
bad00fb0d663
added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents:
9
diff
changeset
|
655 |
<h2>Glossary</h2> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
656 |
|
10
bad00fb0d663
added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents:
9
diff
changeset
|
657 |
<dl> |
91
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
658 |
<dt><dfn>active touch point</dfn></dt> |
85 | 659 |
<dd> |
91
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
660 |
A <a>touch point</a> which is currently on the screen and is being |
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
661 |
tracked by the user agent. The touch point becomes active when the |
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
662 |
user agent first dispatches a <a>touchstart</a> event indicating its |
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
663 |
appearance. It ceases to be active after the user agent dispatches a |
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
664 |
<a>touchend</a> or <a>touchcancel</a> event indicating that the touch |
b2c4ba0eb943
ISSUE-15: identifier attribute should be an opaque token
Matt Brubeck <mbrubeck@mozilla.com>
parents:
87
diff
changeset
|
665 |
point is removed from the surface or no longer tracked. |
10
bad00fb0d663
added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents:
9
diff
changeset
|
666 |
</dd> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
667 |
|
12 | 668 |
<dt><dfn>touch point</dfn></dt> |
85 | 669 |
<dd> |
670 |
The coordinate point at which a pointer (e.g finger or stylus) |
|
671 |
intersects the target surface of an interface. This may apply to a |
|
672 |
finger touching a touch-screen, or an digital pen writing on a piece |
|
673 |
of paper. |
|
674 |
</dd> |
|
124
a8b5ef36b865
ACTION-81 - explain preventDefault in the glossary.
Sangwhan Moon <smoon@opera.com>
parents:
123
diff
changeset
|
675 |
|
a8b5ef36b865
ACTION-81 - explain preventDefault in the glossary.
Sangwhan Moon <smoon@opera.com>
parents:
123
diff
changeset
|
676 |
<dt><dfn>preventDefault</dfn></dt> |
a8b5ef36b865
ACTION-81 - explain preventDefault in the glossary.
Sangwhan Moon <smoon@opera.com>
parents:
123
diff
changeset
|
677 |
<dd> |
a8b5ef36b865
ACTION-81 - explain preventDefault in the glossary.
Sangwhan Moon <smoon@opera.com>
parents:
123
diff
changeset
|
678 |
If a event is cancelable, the preventDefault method is used to signify |
a8b5ef36b865
ACTION-81 - explain preventDefault in the glossary.
Sangwhan Moon <smoon@opera.com>
parents:
123
diff
changeset
|
679 |
that the event is to be canceled, and any default actions defined in the |
a8b5ef36b865
ACTION-81 - explain preventDefault in the glossary.
Sangwhan Moon <smoon@opera.com>
parents:
123
diff
changeset
|
680 |
user agent as a result of this event, or consequential events from the |
a8b5ef36b865
ACTION-81 - explain preventDefault in the glossary.
Sangwhan Moon <smoon@opera.com>
parents:
123
diff
changeset
|
681 |
canceled event will not occur. Calling this method on non-cancelable |
a8b5ef36b865
ACTION-81 - explain preventDefault in the glossary.
Sangwhan Moon <smoon@opera.com>
parents:
123
diff
changeset
|
682 |
events will have no effect. |
a8b5ef36b865
ACTION-81 - explain preventDefault in the glossary.
Sangwhan Moon <smoon@opera.com>
parents:
123
diff
changeset
|
683 |
</dd> |
10
bad00fb0d663
added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents:
9
diff
changeset
|
684 |
</dl> |
bad00fb0d663
added identifier algorithm; added glossary; added timestamp to TouchPoint
shepazu <schepers@w3.org>
parents:
9
diff
changeset
|
685 |
</section> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
686 |
|
71
4c4b691aab2a
Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
69
diff
changeset
|
687 |
<section id='issues' class='informative'> |
4c4b691aab2a
Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
69
diff
changeset
|
688 |
<h2>Issues</h2> |
85 | 689 |
<p> |
690 |
The working group maintains <a |
|
691 |
href='http://www.w3.org/2010/webevents/track/products/2' |
|
692 |
>a list of open issues in this specification</a>. These issues may be |
|
693 |
addressed in future revisions of the specification. |
|
694 |
</p> |
|
71
4c4b691aab2a
Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
69
diff
changeset
|
695 |
</section> |
4c4b691aab2a
Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
69
diff
changeset
|
696 |
|
4c4b691aab2a
Add a link to the issue tracker.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
69
diff
changeset
|
697 |
<section class='appendix informative'> |
4 | 698 |
<h2>Acknowledgements</h2> |
699 |
<p> |
|
85 | 700 |
Many thanks to the WebKit engineers for developing the model used as a |
701 |
basis for this spec, Neil Roberts (SitePen) for his summary of WebKit |
|
86 | 702 |
touch events, Peter-Paul Koch (PPK) for his write-ups and suggestions, |
85 | 703 |
Robin Berjon for developing the <a |
704 |
href="http://dev.w3.org/2009/dap/ReSpec.js/documentation.html" |
|
705 |
>ReSpec.js spec authoring tool</a>, and the WebEvents WG for their many |
|
706 |
contributions. |
|
4 | 707 |
</p> |
20
3a04fe9b8ef2
Clean up some trailing whitespace and old comments.
Matt Brubeck <mbrubeck@mozilla.com>
parents:
19
diff
changeset
|
708 |
|
85 | 709 |
<p> |
710 |
Many others have made additional comments as the spec developed, which |
|
711 |
have led to steady improvements. Among them are Matthew Schinckel, |
|
712 |
Andrew Grieve, and Cathy Chan. If I inadvertently omitted your name, |
|
713 |
please let me know. |
|
714 |
</p> |
|
4 | 715 |
</section> |
716 |
</body> |
|
717 |
</html> |