blob: 99fa1c27a203770b657f20504e3af841c46784fd (
plain)
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
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
---
title: touchcancel
slug: Web/API/Element/touchcancel_event
translation_of: Web/API/Element/touchcancel_event
---
<p>{{APIRef}}</p>
<p><code>touchcancel 觸控點發生失效的事件被觸發(例如太多觸控點時)</code></p>
<h2 id="一般資訊">一般資訊</h2>
<dl>
<dt style="float: left; text-align: right; width: 120px;">規範</dt>
<dd style="margin: 0 0 0 120px;"><a class="external" href="http://www.w3.org/TR/touch-events/#the-touchcancel-event">Touch Events</a></dd>
<dt style="float: left; text-align: right; width: 120px;">介面</dt>
<dd style="margin: 0 0 0 120px;">TouchEvent</dd>
<dt style="float: left; text-align: right; width: 120px;">起泡事件</dt>
<dd style="margin: 0 0 0 120px;">是</dd>
<dt style="float: left; text-align: right; width: 120px;">可取消</dt>
<dd style="margin: 0 0 0 120px;">否</dd>
<dt style="float: left; text-align: right; width: 120px;">對象</dt>
<dd style="margin: 0 0 0 120px;">Document, Element</dd>
<dt style="float: left; text-align: right; width: 120px;">預設行為</dt>
<dd style="margin: 0 0 0 120px;">無</dd>
</dl>
<h2 id="屬性">屬性</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Property</th>
<th scope="col">Type</th>
<th scope="col">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>target</code> {{readonlyInline}}</td>
<td>EventTarget</td>
<td>The event target (the topmost target in the DOM tree).</td>
</tr>
<tr>
<td><code>type</code> {{readonlyInline}}</td>
<td>DOMString</td>
<td>The type of event.</td>
</tr>
<tr>
<td><code>bubbles</code> {{readonlyInline}}</td>
<td>Boolean</td>
<td>Whether the event normally bubbles or not.</td>
</tr>
<tr>
<td><code>cancelable</code> {{readonlyInline}}</td>
<td>Boolean</td>
<td>Whether the event is cancellable or not.</td>
</tr>
<tr>
<td><code>view</code> {{readonlyInline}}</td>
<td>WindowProxy</td>
<td><a href="/en-US/docs/Web/API/Document/defaultView" title="In browsers, document.defaultView returns the window object associated with a document, or null if none is available."><code>document.defaultView</code></a> (<code>window</code> of the document)</td>
</tr>
<tr>
<td><code>detail</code> {{readonlyInline}}</td>
<td>long (float)</td>
<td>0.</td>
</tr>
<tr>
<td><code>touches</code> {{readonlyInline}}</td>
<td>TouchList</td>
<td>A list of <a href="/en/DOM/Touch"><code>Touch</code></a>es for every point of contact currently touching the surface.</td>
</tr>
<tr>
<td><code>targetTouches</code> {{readonlyInline}}</td>
<td>TouchList</td>
<td>A list of <a href="/en/DOM/Touch"><code>Touch</code></a>es for every point of contact that is touching the surface and started on the element that is the target of the current event.</td>
</tr>
<tr>
<td><code>changedTouches</code> {{readonlyInline}}</td>
<td>TouchList</td>
<td>A list of <a href="/en-US/docs/DOM/Touch"><code>Touch</code></a>es for every point of contact which contributed to the event.<br>
For the touchstart event this must be a list of the touch points that just became active with the current event. For the touchmove event this must be a list of the touch points that have moved since the last event. For the touchend and touchcancel events this must be a list of the touch points that have just been removed from the surface.</td>
</tr>
<tr>
<td><code>ctrlKey</code> {{readonlyInline}}</td>
<td>boolean</td>
<td><code>true</code> if the control key was down when the event was fired. <code>false</code> otherwise.</td>
</tr>
<tr>
<td><code>shiftKey</code> {{readonlyInline}}</td>
<td>boolean</td>
<td><code>true</code> if the shift key was down when the event was fired. <code>false</code> otherwise.</td>
</tr>
<tr>
<td><code>altKey</code> {{readonlyInline}}</td>
<td>boolean</td>
<td><code>true</code> if the alt key was down when the event was fired. <code>false</code> otherwise.</td>
</tr>
<tr>
<td><code>metaKey</code> {{readonlyInline}}</td>
<td>boolean</td>
<td><code>true</code> if the meta key was down when the event was fired. <code>false</code> otherwise.</td>
</tr>
</tbody>
</table>
<h2 id="範例">範例</h2>
<p>各種觸控事件的範例:<a href="/en-US/docs/DOM/Touch_events">Touch events</a>。</p>
<h2 id="瀏覽器相容性">瀏覽器相容性</h2>
<p>{{CompatibilityTable}}</p>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>Feature</th>
<th>Chrome</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari (WebKit)</th>
</tr>
<tr>
<td>Basic support</td>
<td>{{CompatChrome("22.0")}}</td>
<td>{{CompatGeckoDesktop("18.0")}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatNo}}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>Feature</th>
<th>Android</th>
<th>Android Webview</th>
<th>Chrome for Android</th>
<th>Firefox Mobile (Gecko)</th>
<th>Firefox OS</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
</tr>
<tr>
<td>Basic support</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoMobile("6.0")}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>11</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
</tr>
</tbody>
</table>
</div>
<h2 id="相關事件">相關事件</h2>
<p>{{ domxref("GlobalEventHandlers.ontouchcancel","ontouchcancel")}}</p>
|