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
|
---
title: Event
slug: Web/API/Event
tags:
- API
- DOM
- Event
- Interface
- Reference
- Событие
translation_of: Web/API/Event
---
<p>{{APIRef("DOM")}}</p>
<p>Интерфейс <code><strong>Event</strong></code> представляет собой любое событие, которое происходит в <a href="/ru/docs/DOM/DOM_Reference">DOM</a>; некоторые из них генерируемые пользователем (клик мышью или нажатие клавиши на клавиатуре), а некоторые - генерируемые API (события, обозначающие завершение процесса анимации, приостановка видео и т.д.). Существует много типов событий, некоторые из них используют интерфейсы, базирующиеся на главном интерфейсе <code>Event</code>. <code>Event</code> содержит общие свойства и методы для всех событий.</p>
<h2 id="Introduction" name="Introduction">Интерфейсы, основанные на <code>Event</code></h2>
<p>Ниже приведён список интерфейсов, основанных на главном интерфейсе <code>Event</code>, а также указаны ссылки на них в документации MDN API. Заметьте, что имена всех интерфейсов оканчиваются на "Event".</p>
<div class="index">
<ul>
<li>{{domxref("AnimationEvent")}}</li>
<li>{{domxref("AudioProcessingEvent")}}</li>
<li>{{domxref("BeforeInputEvent")}}</li>
<li>{{domxref("BeforeUnloadEvent")}}</li>
<li>{{domxref("BlobEvent")}}</li>
<li>{{domxref("ClipboardEvent")}}</li>
<li>{{domxref("CloseEvent")}}</li>
<li>{{domxref("CompositionEvent")}}</li>
<li>{{domxref("CSSFontFaceLoadEvent")}}</li>
<li>{{domxref("CustomEvent")}}</li>
<li>{{domxref("DeviceLightEvent")}}</li>
<li>{{domxref("DeviceMotionEvent")}}</li>
<li>{{domxref("DeviceOrientationEvent")}}</li>
<li>{{domxref("DeviceProximityEvent")}}</li>
<li>{{domxref("DOMTransactionEvent")}}</li>
<li>{{domxref("DragEvent")}}</li>
<li>{{domxref("EditingBeforeInputEvent")}}</li>
<li>{{domxref("ErrorEvent")}}</li>
<li>{{domxref("FetchEvent")}}</li>
<li>{{domxref("FocusEvent")}}</li>
<li>{{domxref("GamepadEvent")}}</li>
<li>{{domxref("HashChangeEvent")}}</li>
<li>{{domxref("IDBVersionChangeEvent")}}</li>
<li>{{domxref("InputEvent")}}</li>
<li>{{domxref("KeyboardEvent")}}</li>
<li>{{domxref("MediaStreamEvent")}}</li>
<li>{{domxref("MessageEvent")}}</li>
<li>{{domxref("MouseEvent")}}</li>
<li>{{domxref("MutationEvent")}}</li>
<li>{{domxref("OfflineAudioCompletionEvent")}}</li>
<li>{{domxref("PageTransitionEvent")}}</li>
<li>{{domxref("PointerEvent")}}</li>
<li>{{domxref("PopStateEvent")}}</li>
<li>{{domxref("ProgressEvent")}}</li>
<li>{{domxref("RelatedEvent")}}</li>
<li>{{domxref("RTCDataChannelEvent")}}</li>
<li>{{domxref("RTCIdentityErrorEvent")}}</li>
<li>{{domxref("RTCIdentityEvent")}}</li>
<li>{{domxref("RTCPeerConnectionIceEvent")}}</li>
<li>{{domxref("SensorEvent")}}</li>
<li>{{domxref("StorageEvent")}}</li>
<li>{{domxref("SVGEvent")}}</li>
<li>{{domxref("SVGZoomEvent")}}</li>
<li>{{domxref("TimeEvent")}}</li>
<li>{{domxref("TouchEvent")}}</li>
<li>{{domxref("TrackEvent")}}</li>
<li>{{domxref("TransitionEvent")}}</li>
<li>{{domxref("UIEvent")}}</li>
<li>{{domxref("UserProximityEvent")}}</li>
<li>{{domxref("WebGLContextEvent")}}</li>
<li>{{domxref("WheelEvent")}}</li>
</ul>
</div>
<h2 id="Constructor" name="Constructor">Конструктор</h2>
<dl>
<dt>{{domxref("Event.Event", "Event()")}}</dt>
<dd>Создаёт объект <code>Event</code> и возвращает его вызывающему.</dd>
</dl>
<h2 id="Properties" name="Properties">Свойства</h2>
<dl>
<dt>{{domxref("Event.bubbles")}} {{readonlyinline}}</dt>
<dd>Логическое значение, указывающее, всплыло ли событие вверх по DOM или нет.</dd>
<dt>{{domxref("Event.cancelBubble")}}</dt>
<dd>Историческое название синонима {{domxref("Event.stopPropagation()")}}. Если установить значение в <code>true</code> до возврата из обработчика события (Event Handler), то событие не будет распространяться дальше (например, на обработчики для родительских узлов).</dd>
<dt>{{domxref("Event.cancelable")}} {{readonlyinline}}</dt>
<dd>Логическое значение, показывающее возможность отмены события.</dd>
<dt>{{domxref("Event.composed")}} {{ReadOnlyInline}}</dt>
<dd>Логическое значение, показывающее может или нет событие всплывать через границы между shadow DOM (внутренний DOM конкретного элемента) и обычного DOM документа.</dd>
<dt>{{domxref("Event.currentTarget")}} {{readonlyinline}}</dt>
<dd>Ссылка на текущий зарегистрированный объект, на котором обрабатывается событие. Это объект, которому планируется отправка события; поведение можно изменить с использованием перенаправления (<em>retargeting</em>).</dd>
<dt>{{domxref("Event.deepPath")}} {{non-standard_inline}}</dt>
<dd>{{jsxref("Array", "Массив")}} DOM-{{domxref("Node", "узлов")}}, через которые всплывало событие.</dd>
<dt>{{domxref("Event.defaultPrevented")}} {{readonlyinline}}</dt>
<dd>Показывает, была ли для события вызвана функция {{domxref("event.preventDefault()")}}.</dd>
<dt>{{domxref("Event.eventPhase")}} {{readonlyinline}}</dt>
<dd>Указывает фазу процесса обработки события.</dd>
<dt>{{domxref("Event.explicitOriginalTarget")}} {{non-standard_inline}} {{readonlyinline}}</dt>
<dd>Явный первоначальный целевой объект события (Mozilla-специфичный). Не может содержать <a href="/en-US/docs/Mozilla/Tech/XBL/XBL_1.0_Reference/Anonymous_Content">анонимного контента</a>.</dd>
<dt>{{domxref("Event.originalTarget")}} {{non-standard_inline}} {{readonlyinline}}</dt>
<dd>Первоначальный целевой объект события до перенаправлений (Mozilla-специфичный). Может быть из <a href="/en-US/docs/Mozilla/Tech/XBL/XBL_1.0_Reference/Anonymous_Content">анонимного контента</a>.</dd>
<dt>{{domxref("Event.returnValue")}} {{non-standard_inline}}</dt>
<dd>Нестандартная альтернатива (оставшаяся от старых версий Microsoft Internet Explorer) для {{domxref("Event.preventDefault()")}} и {{domxref("Event.defaultPrevented")}}.</dd>
<dt>{{domxref("Event.scoped")}} {{readonlyinline}} {{obsolete_inline}}</dt>
<dd>{{jsxref("Boolean", "Логическое значение")}}, показывающее всплывает ли данное событие через shadow root (внутренний DOM элемента). Это свойство было переименовано в {{domxref("Event.composed", "composed")}}.</dd>
<dt>{{domxref("Event.srcElement")}} {{non-standard_inline}}</dt>
<dd>Нестандартный синоним (остался от старых версий Microsoft Internet Explorer) для {{domxref("Event.target")}}.</dd>
<dt>{{domxref("Event.target")}} {{readonlyinline}}</dt>
<dd>Ссылка на целевой объект, на котором произошло событие.</dd>
<dt>{{domxref("Event.timeStamp")}} {{readonlyinline}}</dt>
<dd>Время, когда событие было создано (в миллисекундах). По спецификации это время от начала Эпохи (Unix Epoch), но в действительности в разных браузерах определяется по-разному; кроме того, ведётся работа по изменению его на {{domxref("DOMHighResTimeStamp")}} тип.</dd>
<dt>{{domxref("Event.type")}} {{readonlyinline}}</dt>
<dd>Название события (без учёта регистра символов).</dd>
<dt>{{domxref("Event.isTrusted")}} {{readonlyinline}}</dt>
<dd>Показывает было или нет событие инициировано браузером (например, по клику мышью) или из скрипта (например, через функцию создания события, такую как <a href="/en-US/docs/DOM/event.initEvent">event.initEvent</a>)</dd>
</dl>
<h2 id="Methods" name="Methods">Методы</h2>
<p> </p>
<dl>
<dt>{{domxref("Event.createEvent()")}} </dt>
<dd>
<p>Создаёт новое событие, которое затем должно быть проинициализировано вызовом его метода <code>initEvent()</code>.</p>
</dd>
</dl>
<p> </p>
<dl>
<dt>{{domxref("Event.initEvent()")}} {{deprecated_inline}}</dt>
<dd>Инициализация значений созданного с помощью <a href="https://developer.mozilla.org/en-US/docs/Web/API/Document/createEvent" title="Creates an event of the type specified. The returned object should be first initialized and can then be passed to element.dispatchEvent.">Document.createEvent()</a> события. Если событие уже отправлено, то эта функция ничего не делает.</dd>
<dt>{{domxref("Event.preventBubble()")}} {{non-standard_inline}} {{Obsolete_inline(24)}}</dt>
<dd>Предотвращает всплытие события. Устаревшая, используйте вместо неё {{domxref("event.stopPropagation")}}.</dd>
<dt>{{domxref("Event.preventCapture()")}} {{non-standard_inline}} {{Obsolete_inline(24)}}</dt>
<dd>Устаревшая, используйте вместо неё {{domxref("event.stopPropagation")}}.</dd>
<dt>{{domxref("Event.preventDefault()")}}</dt>
<dd>Отменяет событие (если его возможно отменить).</dd>
<dt>{{domxref("Event.stopImmediatePropagation()")}}</dt>
<dd>Для конкретного события не будет больше вызвано обработчиков. Ни тех, которые привязаны к этому же элементу (на котором работает обработчик, который вызывает этот Event.stopImmediatePropagation()), ни других, которые могли бы вызваться при распространении события позже (например, в фазе перехвата - capture).</dd>
<dt>{{domxref("Event.stopPropagation()")}}</dt>
<dd>Остановка распространения события далее по DOM.</dd>
<dt>{{domxref("Event.getPreventDefault()")}} {{non-standard_inline}}</dt>
<dd>Нестандартная. Возвращает значение {{domxref("Event.defaultPrevented")}}. Используйте вместо неё {{domxref("Event.defaultPrevented")}}.</dd>
</dl>
<h2 id="Спецификации">Спецификации</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Спецификация</th>
<th scope="col">Статус</th>
<th scope="col">Комментарий</th>
</tr>
<tr>
<td>{{SpecName('DOM WHATWG', '#interface-event', 'Event')}}</td>
<td>{{Spec2('DOM WHATWG')}}</td>
<td> </td>
</tr>
</tbody>
</table>
<h2 id="Совместимость_браузеров">Совместимость браузеров</h2>
<p>{{Compat("api.Event")}}</p>
<h2 id="See_also" name="See_also">Смотрите также</h2>
<ul>
<li>Типы событий: <a href="/en-US/docs/Web/Reference/Events">Event reference</a></li>
<li><a href="/en-US/docs/Web/API/Event/Comparison_of_Event_Targets">Сравнение Event Targets</a> (target и currentTarget и relatedTarget и originalTarget)</li>
<li><a href="/en-US/docs/Web/Guide/DOM/Events/Creating_and_triggering_events">Creating and triggering custom events</a></li>
<li>Для разработчиков дополнений Firefox:
<ul>
<li><a href="/en-US/docs/Listening_to_events_in_Firefox_extensions">Listening to events in Firefox extensions</a></li>
<li><a href="/en-US/docs/Listening_to_events_on_all_tabs">Listening to events on all tabs</a></li>
</ul>
</li>
<li><a class="link-https" href="https://wiki.mozilla.org/Events">Mozilla related events in real life at wiki.mozilla.org</a></li>
</ul>
|
