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.

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

A historical alias to Event.stopPropagation(). Setting its value to true 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 DOM Nodes 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() and Event.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 to composed.

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. Use Event.defaultPrevented instead.

Specifications

Browser compatibility

[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:
  • Listening to events in Firefox extensions
  • Listening to events on all tabs