Event

Baseline Weitgehend verfgbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Juli 2015 browserbergreifend verfgbar.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Hinweis: Diese Funktion ist in Web Workers verfgbar.

Das Event-Interface reprsentiert ein Ereignis, das auf einem EventTarget stattfindet.

Ein Ereignis kann durch eine Benutzeraktion ausgelst werden, z.B. durch Klicken der Maustaste oder Drcken der Tastatur, oder durch APIs generiert werden, um den Fortschritt einer asynchronen Aufgabe darzustellen. Es kann auch programmgesteuert ausgelst werden, etwa durch den Aufruf der Methode HTMLElement.click() eines Elements oder durch die Definition des Ereignisses und dessen Versand an ein spezifiziertes Ziel mittels EventTarget.dispatchEvent().

Es gibt viele Arten von Ereignissen, von denen einige andere Schnittstellen basierend auf der Hauptschnittstelle Event verwenden. Event selbst enthlt die Eigenschaften und Methoden, die allen Ereignissen gemeinsam sind.

Viele DOM-Elemente knnen so eingerichtet werden, dass sie diese Ereignisse akzeptieren (oder "beobachten") und Code ausfhren, um sie zu verarbeiten (oder "handhaben"). Ereignis-Handler werden normalerweise mit verschiedenen HTML-Elementen (wie <button>, <div>, <span>, usw.) verbunden (oder "angehngt"), indem EventTarget.addEventListener() verwendet wird, was im Allgemeinen die alten HTML-Ereignis-Handler-Attribute ersetzt. Solche Handler knnen, wenn sie richtig hinzugefgt wurden, bei Bedarf auch ber removeEventListener() getrennt werden.

Hinweis: Ein Element kann mehrere derartige Handler haben, selbst fr genau dasselbe Ereignisinsbesondere, wenn separate, unabhngige Code-Module sie jeweils fr eigene Zwecke anhngen. (Zum Beispiel eine Webseite, die ein Werbemodul und ein Statistikmodul enthlt, die beide das Ansehen von Videos berwachen.)

Wenn es viele verschachtelte Elemente gibt, die jeweils einen eigenen Handler haben, kann die Ereignisverarbeitung sehr kompliziert werdeninsbesondere, wenn ein bergeordnetes Element dasselbe Ereignis wie seine Kindelemente empfngt, weil sie "rumlich" berlappen und das Ereignis technisch in beiden auftritt. Die Verarbeitungsreihenfolge solcher Ereignisse hngt von den Event bubbling Einstellungen jedes ausgelsten Handlers ab.

Schnittstellen basierend auf Event

Im Folgenden finden Sie eine Liste der Schnittstellen, die auf der Hauptschnittstelle Event basieren, mit Links zu deren jeweiliger Dokumentation im MDN API Referenz.

Beachten Sie, dass alle Ereignisschnittstellen Namen haben, die mit "Event" enden.

Konstruktor

Event(): Erstellt ein Event-Objekt und gibt es an den Aufrufer zurck.

Instanz-Eigenschaften

Event.bubbles Schreibgeschtzt: Ein Boolean-Wert, der angibt, ob das Ereignis durch das DOM nach oben "steigt".
Event.cancelable Schreibgeschtzt: Ein Boolean-Wert, der angibt, ob das Ereignis abgebrochen werden kann.
Event.composed Schreibgeschtzt: Ein Boolean, der angibt, ob das Ereignis ber die Grenze zwischen dem Shadow DOM und dem regulren DOM steigen kann.
Event.currentTarget Schreibgeschtzt: Eine Referenz auf das aktuell registrierte Ziel fr das Ereignis. Dies ist das Objekt, an das das Ereignis aktuell gesendet werden soll. Es ist mglich, dass dies im Laufe der Zeit durch Retargeting gendert wurde.
Event.defaultPrevented Schreibgeschtzt: Gibt an, ob der Aufruf von event.preventDefault() das Ereignis abgebrochen hat.
Event.eventPhase Schreibgeschtzt: Gibt an, welche Phase des Ereignisflusses gerade verarbeitet wird. Es ist eine der folgenden Zahlen: NONE, CAPTURING_PHASE, AT_TARGET, BUBBLING_PHASE.
Event.isTrusted Schreibgeschtzt: Gibt an, ob das Ereignis vom Browser (z.B. nach einem Benutzer-Klick) oder durch ein Skript (z.B. unter Verwendung einer Ereigniserstellungsmethode) initiiert wurde.
Event.srcElement Schreibgeschtzt: Ein Alias fr die Event.target-Eigenschaft. Verwenden Sie stattdessen Event.target.
Event.target Schreibgeschtzt: Eine Referenz auf das Objekt, an das das Ereignis ursprnglich gesendet wurde.
Event.timeStamp Schreibgeschtzt: Der Zeitpunkt, zu dem das Ereignis erstellt wurde (in Millisekunden). Laut Spezifikation ist dieser Wert die Zeit seit Epochaber in der Realitt variieren die Definitionen der Browser. Darber hinaus wird daran gearbeitet, dies stattdessen in einen DOMHighResTimeStamp zu ndern.
Event.type Schreibgeschtzt: Der Name, der den Typ des Ereignisses identifiziert.

Veraltete und nicht standardisierte Eigenschaften

Event.cancelBubble: Ein historisches Alias zu Event.stopPropagation(), das stattdessen verwendet werden sollte. Wenn sein Wert vor der Rckgabe von einem Ereignis-Handler auf true gesetzt wird, wird die Verbreitung des Ereignisses verhindert.
Event.explicitOriginalTarget Schreibgeschtzt: Das explizite ursprngliche Ziel des Ereignisses.
Event.originalTarget Schreibgeschtzt: Das ursprngliche Ziel des Ereignisses, bevor irgendein Retargeting stattfand.
Event.returnValue: Eine historische Eigenschaft, die immer noch untersttzt wird, um sicherzustellen, dass bestehende Seiten weiterhin funktionieren. Verwenden Sie stattdessen Event.preventDefault() und Event.defaultPrevented.
Event.scoped Schreibgeschtzt: Ein Boolean-Wert, der angibt, ob das gegebene Ereignis durch den Shadow-Root in das Standard-DOM "steigen" wird. Verwenden Sie stattdessen composed.

Instanz-Methoden

Event.composedPath(): Gibt den Pfad des Ereignisses zurck (ein Array von Objekten, auf denen Listener aufgerufen werden). Dies schliet keine Knoten in Schattenbumen ein, wenn der Schatten-Root mit seinem ShadowRoot.mode im geschlossenen Modus erstellt wurde.
Event.preventDefault(): Hebt das Ereignis (wenn es abbrechbar ist) auf.
Event.stopImmediatePropagation(): Verhindert speziell fr dieses Ereignis, dass alle anderen Listener aufgerufen werden. Dies schliet Listener ein, die an dasselbe Element angehngt sind, sowie solche, die an Elemente angehngt sind, die spter durchlaufen werden (z.B. whrend der Erfassungsphase).
Event.stopPropagation(): Stoppt die Weiterverbreitung von Ereignissen im DOM.

Veraltete Methoden

Event.initEvent(): Initialisiert den Wert eines erstellten Ereignisses. Wenn das Ereignis bereits gesendet wurde, tut diese Methode nichts. Verwenden Sie stattdessen den Konstruktor (Event()).

Spezifikationen

Spezifikation
DOM # interface-event

Browser-Kompatibilitt

Siehe auch

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden

Document Object Model (DOM)
Event
Konstruktor
1. Event()
Instanzeigenschaften
Instanzmethoden
Verwandte Seiten fr DOM
Anleitungen
1. Anatomie des DOM
2. Attributreflexion
3. Auswahl und Traversierung im DOM-Baum
4. Erstellen und Aktualisieren des DOM-Baums
5. Arbeiten mit Ereignissen