Das Event
Interface repräsentiert jegliches Ereignis, das im DOM auftritt.
Ein Ereignis kann durch Benutzerinteraktion ausgelöst werden, z.B das Klicken einer Maustaste oder Eingaben der Tastatur, oder durch eine API generiert werden um den Fortschritt eines asynchronen Prozesses zu repräsentieren. Es kann auch durch ein Programm ausgelöst werden, beispielsweise indem die HTMLElement.click()
Method eines Elements aufgerufen wird, oder indem ein Ereignis definiert wird und es danach mithilfe von EventTarget.dispatchEvent()
an ein Ziel versandt wird.
Es gibt eine Vielzahl verschiedener Typen von Ereignissen, von denen manche erweiterte Schnittstellen basieren auf dem zentralen Event
Interface benutzen. Event
beinhaltet alle Attribute und Methoden, die allen Ereignissen gemein sind.
Viele DOM-Element können für das Empfangen dieser Events konfiguriert werden und rufen Code auf, um sie zu behandeln. Event-Handler werden normalerweise mit unterschiedlichen HTML-Elementen (so wie <button>
, <div>
, <span>
, etc.) verbunden, durch den Aufruf von EventTarget.addEventListener()
. Dies ersetzt größtenteils die alten HTML Event Handler Attribute. Die neueren Event-Handler können außerdem nötigenfalls mithilfe von removeEventListener()
wieder entfernt werden.
Note: Ein Element kann mehrere solcher Handler besitzen, sogar für das selbe Ereignis—so können sie verschiedene, unabhängige Code-Module angebracht werden, jeweils für deren unabhängige Zwecke. (Zum Beispiel eine Webseite mit einem Werbemodul und einem Statistikmodel, die beide Videowiedergabe überwachen.)
Gitb es viele verschachtelte Element, jedes mit eigenen Event-Handlern, kann das Verarbeiten von Ereignissen siehr schnell komplex werden—im Speziellen wenn ein Elternelement die selben Ereignissen wie sein Kindelement empfängt, weil sie sich überlappen und so Ereignisse technisch gesehen in beiden geschehen. Die Behandlungsreihenfolge solcher Ereignisse hängen von Event bubbling and capture Konfigurationen jedes ausgelösten Event-Handlers ab.
Interfaces based on Event
Below is a list of interfaces which are based on the main Event
interface, with links to their respective documentation in the MDN API reference. Note that all event interfaces have names which end in "Event".
AnimationEvent
AudioProcessingEvent
BeforeInputEvent
BeforeUnloadEvent
BlobEvent
ClipboardEvent
CloseEvent
CompositionEvent
CSSFontFaceLoadEvent
CustomEvent
DeviceLightEvent
DeviceMotionEvent
DeviceOrientationEvent
DeviceProximityEvent
DOMTransactionEvent
DragEvent
EditingBeforeInputEvent
ErrorEvent
FetchEvent
FocusEvent
GamepadEvent
HashChangeEvent
IDBVersionChangeEvent
InputEvent
KeyboardEvent
MediaStreamEvent
MessageEvent
MouseEvent
MutationEvent
OfflineAudioCompletionEvent
PageTransitionEvent
PointerEvent
PopStateEvent
ProgressEvent
RelatedEvent
RTCDataChannelEvent
RTCIdentityErrorEvent
RTCIdentityEvent
RTCPeerConnectionIceEvent
SensorEvent
StorageEvent
SVGEvent
SVGZoomEvent
TimeEvent
TouchEvent
TrackEvent
TransitionEvent
UIEvent
UserProximityEvent
WebGLContextEvent
WheelEvent
Constructor
Event()
- Creates an
Event
object, returning it to the caller.
Properties
Event.bubbles
Schreibgeschützt- A Boolean indicating whether the event bubbles up through the DOM or not.
Event.cancelBubble
- A historical alias to
Event.stopPropagation()
. Setting its value totrue
before returning from an event handler prevents propagation of the event. Event.cancelable
Schreibgeschützt- A Boolean indicating whether the event is cancelable.
Event.composed
Schreibgeschützt- A Boolean value indicating whether or not the event can bubble across the boundary between the shadow DOM and the regular DOM.
Event.currentTarget
Schreibgeschützt- A reference to the currently registered target for the event. This is the object to which the event is currently slated to be sent; it's possible this has been changed along the way through retargeting.
Event.deepPath
- An
Array
of DOMNode
s through which the event has bubbled. Event.defaultPrevented
Schreibgeschützt- Indicates whether or not
event.preventDefault()
has been called on the event. Event.eventPhase
Schreibgeschützt- Indicates which phase of the event flow is being processed.
Event.explicitOriginalTarget
Schreibgeschützt- The explicit original target of the event (Mozilla-specific).
Event.originalTarget
Schreibgeschützt- The original target of the event, before any retargetings (Mozilla-specific).
Event.returnValue
- A non-standard alternative (from old versions of Microsoft Internet Explorer) to
Event.preventDefault()
andEvent.defaultPrevented
. Event.scoped
Schreibgeschützt- A
Boolean
indicating whether the given event will bubble across through the shadow root into the standard DOM. This property has been renamed tocomposed
. Event.srcElement
- A non-standard alias (from old versions of Microsoft Internet Explorer) for
Event.target
. Event.target
Schreibgeschützt- A reference to the target to which the event was originally dispatched.
Event.timeStamp
Schreibgeschützt- The time at which the event was created, in milliseconds. By specification, this value is time since epoch, but in reality browsers' definitions vary; in addition, work is underway to change this to be a
DOMHighResTimeStamp
instead. Event.type
Schreibgeschützt- The name of the event (case-insensitive).
Event.isTrusted
Schreibgeschützt- Indicates whether or not the event was initiated by the browser (after a user click for instance) or by a script (using an event creation method, like event.initEvent)
Methods
Event.initEvent()
- Initializes the value of an Event created. If the event has already being dispatched, this method does nothing.
Event.preventBubble()
Veraltet seit Gecko 24- Prevents the event from bubbling. Obsolete, use
event.stopPropagation
instead. Event.preventCapture()
Veraltet seit Gecko 24- Obsolete, use
event.stopPropagation
instead. Event.preventDefault()
- Cancels the event (if it is cancelable).
Event.stopImmediatePropagation()
- For this particular event, no other listener will be called. Neither those attached on the same element, nor those attached on elements which will be traversed later (in capture phase, for instance)
Event.stopPropagation()
- Stops the propagation of events further along in the DOM.
Event.getPreventDefault()
- Non-standard. Returns the value of
Event.defaultPrevented
. UseEvent.defaultPrevented
instead.
Specifications
Specification | Status | Comment |
---|---|---|
DOM Die Definition von 'Event' in dieser Spezifikation. |
Lebender Standard |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) |
cancelBubble defined on Event |
? | 53 (53)[1] | ? | ? | ? |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) |
cancelBubble defined on Event |
? | 53.0 (53)[1] | ? | ? | ? |
[1] Previous to Firefox 52, this property was defined on the UIEvent
interface. See Bug 1298970 for more details.
See also
- Types of events available: Event reference
- Comparison of Event Targets (target vs currentTarget vs relatedTarget vs originalTarget)
- Creating and triggering custom events
- For Firefox add-on developers: