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
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
|
---
title: UIEvent
slug: Web/API/UIEvent
tags:
- API
- DOM
- Event
- Reference
- UIEvent
translation_of: Web/API/UIEvent
---
<p>{{APIRef("DOM Events")}}</p>
<p> <code>UIEvent</code> 接口表示简单的用户界面事件。</p>
<p><code>UIEvent</code> 是从 {{domxref("Event")}} 派生出来的。尽管 {{domxref("UIEvent.initUIEvent()")}} 方法为了向后兼容而一直保留着，但是你应该使用 {{domxref("UIEvent.UIEvent", "UIEvent()")}} 构造器来创建 <code>UIEvent</code> 对象。</p>
<p>某些接口是这个的直接或间接后代：{{domxref("MouseEvent")}}, {{domxref("TouchEvent")}}, {{domxref("FocusEvent")}}, {{domxref("KeyboardEvent")}}, {{domxref("WheelEvent")}}, {{domxref("InputEvent")}}, 和{{domxref("CompositionEvent")}}.</p>
<h2 id="Constructors">Constructors</h2>
<dl>
<dt>{{domxref("UIEvent.UIEvent()", "UIEvent()")}}</dt>
<dd>创建一个 <code>UIEvent</code> 对象</dd>
</dl>
<h2 id="属性">属性</h2>
<p><em>也继承了父代 {{domxref("Event")}} 的一些属性。</em></p>
<dl>
<dt>{{domxref("UIEvent.cancelBubble")}} {{Non-standard_inline}} {{Deprecated_inline}}</dt>
<dd>返回一个 {{jsxref("Boolean")}}，表示该事件的冒泡是否被取消。</dd>
</dl>
<dl>
<dt>{{domxref("UIEvent.detail")}}{{readonlyinline}}</dt>
<dd>Returns a <code>long</code> with details about the event, depending on the event type.</dd>
<dt>{{domxref("UIEvent.isChar")}} {{obsolete_inline}} {{readonlyinline}}</dt>
<dd>返回一个 {{jsxref("Boolean")}}，表示该事件是否产生了一个键盘字符（key character）。</dd>
<dt>{{domxref("UIEvent.layerX")}} {{Non-standard_inline}} {{readonlyinline}}</dt>
<dd>返回事件相对于当前层的水平坐标。</dd>
<dt>{{domxref("UIEvent.layerY")}} {{Non-standard_inline}} {{readonlyinline}}</dt>
<dd>返回事件相对于当前层的垂直坐标。</dd>
<dt>{{domxref("UIEvent.pageX")}} {{Non-standard_inline}} {{readonlyinline}}</dt>
<dd>返回事件相对于整个文档的水平坐标。</dd>
<dt>{{domxref("UIEvent.pageY")}} {{Non-standard_inline}} {{readonlyinline}}</dt>
<dd>返回事件相对于整个文档的垂直坐标。</dd>
<dt>{{domxref("UIEvent.sourceCapabilities")}} {{non-standard_inline}} {{readonlyinline}}</dt>
<dd>返回输入设备功能接口的一个实例，它提供有关负责生成 touch 事件的物理设备的信息。</dd>
<dt>{{domxref("UIEvent.view")}}{{readonlyinline}}</dt>
<dd>返回一个包含了产生该事件的视图的 {{domxref("WindowProxy")}} 。</dd>
<dt>{{domxref("UIEvent.which")}} {{Non-standard_inline}} {{readonlyinline}} </dt>
<dd>返回一个对应（键盘）按下的数字类型的 <code>keyCode</code> ，或者一个字母数字键按下时的字符码(<code>charCode</code>)。</dd>
</dl>
<h2 id="方法">方法</h2>
<p><em>也继承了父代 {{domxref("Event")}} 的一些方法。</em></p>
<dl>
<dt>{{domxref("UIEvent.initUIEvent()")}} {{deprecated_inline}}</dt>
<dd>初始化一个 <code>UIEvent</code> 对象。如果事件已经被分派，这个方法什么都不做。</dd>
</dl>
<h2 class="editable" id="规范"><span>规范</span></h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comment</th>
</tr>
<tr>
<td>{{SpecName('InputDeviceCapabilities')}}</td>
<td>{{Spec2('InputDeviceCapabilities')}}</td>
<td>Added <code>sourceCapabilities</code> property.</td>
</tr>
<tr>
<td>{{SpecName('DOM3 Events', '#interface-UIEvent', 'UIEvent')}}</td>
<td>{{Spec2('DOM3 Events')}}</td>
<td>Added the <code>UIEvent()</code> constructor, deprecated the <code>initUIEvent()</code> method and changed the type of <code>view</code>from <code>AbstractView</code> to <code>WindowProxy</code>.</td>
</tr>
<tr>
<td>{{SpecName('DOM2 Events', '#Events-UIEvent', 'UIEvent')}}</td>
<td>{{Spec2('DOM2 Events')}}</td>
<td>Initial definition</td>
</tr>
</tbody>
</table>
<h2 id="浏览器兼容性">浏览器兼容性</h2>
<p>{{CompatibilityTable}}</p>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>Feature</th>
<th>Chrome</th>
<th>Edge</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari</th>
</tr>
<tr>
<td>Basic support</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}<sup>[2]</sup></td>
<td>{{CompatUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatUnknown}}</td>
</tr>
<tr>
<td><code>UIEvent()</code></td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoDesktop(11)}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatUnknown}}</td>
</tr>
<tr>
<td><code>cancelBubble</code> defined on Event</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoDesktop(53)}}<sup>[1]</sup></td>
<td>{{CompatUnknown}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatUnknown}}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>Feature</th>
<th>Android</th>
<th>Edge</th>
<th>Firefox Mobile (Gecko)</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}}<sup>[2]</sup></td>
<td>{{CompatUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatUnknown}}</td>
</tr>
<tr>
<td><code>UIEvent()</code></td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoMobile(11)}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatUnknown}}</td>
</tr>
<tr>
<td><code>cancelBubble</code> defined on Event</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoMobile(53)}}<sup>[1]</sup></td>
<td>{{CompatUnknown}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatUnknown}}</td>
</tr>
</tbody>
</table>
</div>
<p>[1] From Firefox 52, this property is now defined on the {{domxref("Event")}} interface instead. See {{bug(1298970)}} for more details.</p>
<p>[2] The {{domxref("UIEvent.isChar", "isChar")}} property has never been supported by any browser but Firefox, and even on Firefox it's never worked except on Mac OSX. For that reason, it's been removed in Firefox 55 to align with other browsers.</p>
<h2 class="editable" id="相关链接"><span>相关链接</span></h2>
<ul>
<li><a href="https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Building_blocks/Events">Introduction to events</a></li>
<li>{{domxref("Event")}}</li>
</ul>
|
