Event

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".

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 (en-US)
A historical alias to Event.stopPropagation() (en-US). Setting its value to true before returning from an event handler prevents propagation of the event.
Event.cancelable (en-US) Schreibgeschützt
A Boolean indicating whether the event is cancelable.
Event.composed (en-US) 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 (en-US) 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 (en-US)  This API has not been standardized.
An Array of DOM Nodes through which the event has bubbled.
Event.defaultPrevented (en-US) Schreibgeschützt
Indicates whether or not event.preventDefault() (en-US) has been called on the event.
Event.eventPhase (en-US) Schreibgeschützt
Indicates which phase of the event flow is being processed.
Event.explicitOriginalTarget (en-US) This API has not been standardized. Schreibgeschützt
The explicit original target of the event (Mozilla-specific).
Event.originalTarget (en-US) This API has not been standardized. Schreibgeschützt
The original target of the event, before any retargetings (Mozilla-specific).
Event.returnValue (en-US) This API has not been standardized.
A non-standard alternative (from old versions of Microsoft Internet Explorer) to Event.preventDefault() (en-US) and Event.defaultPrevented (en-US).
Event.scoped (en-US) Schreibgeschützt Dies ist eine veraltete API und es wird nicht mehr garantiert, dass sie funktioniert.
A Boolean indicating whether the given event will bubble across through the shadow root into the standard DOM. This property has been renamed to composed (en-US).
Event.srcElement (en-US) This API has not been standardized.
A non-standard alias (from old versions of Microsoft Internet Explorer) for Event.target (en-US).
Event.target (en-US) Schreibgeschützt
A reference to the target to which the event was originally dispatched.
Event.timeStamp (en-US) 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 (en-US) instead.
Event.type (en-US) Schreibgeschützt
The name of the event (case-insensitive).
Event.isTrusted (en-US) 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() (en-US) This deprecated API should no longer be used, but will probably still work.
Initializes the value of an Event created. If the event has already being dispatched, this method does nothing.
Event.preventBubble() This API has not been standardized. Veraltet seit Gecko 24
Prevents the event from bubbling. Obsolete, use event.stopPropagation (en-US) instead.
Event.preventCapture() This API has not been standardized. Veraltet seit Gecko 24
Obsolete, use event.stopPropagation (en-US) instead.
Event.preventDefault() (en-US)
Cancels the event (if it is cancelable).
Event.stopImmediatePropagation() (en-US)
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() (en-US)
Stops the propagation of events further along in the DOM.
Event.getPreventDefault() This API has not been standardized.
Non-standard. Returns the value of Event.defaultPrevented (en-US). Use Event.defaultPrevented (en-US) instead.

Specifications

Specification Status Comment
DOM
Die Definition von 'Event' in dieser Spezifikation.
Lebender Standard

Browser compatibility

Wir konvertieren die Kompatibilitätsdaten in ein maschinenlesbares JSON Format. Diese Kompatibilitätstabelle liegt noch im alten Format vor, denn die darin enthaltenen Daten wurden noch nicht konvertiert. Finde heraus wie du helfen kannst! (en-US)

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 (en-US) interface. See Bug 1298970 for more details.

See also