Arbeiten mit Ereignissen und Ereignis-Handlern

Ereignisse sind auf den Seiten der JavaScript-Objekte dokumentiert, die sie auslösen. Beispielsweise finden Sie heraus, welche Ereignisse im Browserfenster oder im aktuellen Dokument ausgelöst werden, indem Sie die Ereignisse in Window und Document einsehen.

Sie können die Ereignisreferenz nutzen, um herauszufinden, welche JavaScript-Objekte Ereignisse für bestimmte APIs auslösen, z. B. Animation, Medien usw.

Es gibt zwei empfohlene Ansätze zum Registrieren von Handlern. Ereignis-Handler-Code kann ausgeführt werden, wenn ein Ereignis ausgelöst wird, indem er der entsprechenden onevent-Eigenschaft des Ziel-Elements zugewiesen oder indem der Handler als Listener für das Element mit der addEventListener()-Methode registriert wird. In beiden Fällen wird dem Handler ein Objekt übergeben, das der Event-Schnittstelle (oder einer abgeleiteten Schnittstelle) entspricht. Der Hauptunterschied besteht darin, dass mit den Event-Listener-Methoden mehrere Ereignis-Handler hinzugefügt (oder entfernt) werden können.

Per Konvention haben JavaScript-Objekte, die Ereignisse auslösen, entsprechende "onevent"-Eigenschaften (benannt durch das Voranstellen von "on" an den Namen des Ereignisses). Diese Eigenschaften werden aufgerufen, um zugehörigen Handler-Code auszuführen, wenn das Ereignis ausgelöst wird, und können auch direkt durch Ihren eigenen Code aufgerufen werden.

Um Ereignis-Handler-Code zu setzen, können Sie ihn einfach der entsprechenden onevent-Eigenschaft zuweisen. Nur ein Ereignis-Handler kann für jedes Ereignis in einem Element zugewiesen werden. Bei Bedarf kann der Handler durch Zuweisung einer anderen Funktion zu derselben Eigenschaft ersetzt werden.

Unten zeigen wir, wie man eine greet()-Funktion für das click-Ereignis mittels der onclick-Eigenschaft festlegt.

const btn = document.querySelector("button");

function greet(event) {
  console.log("greet:", event);
}

btn.onclick = greet;

Beachten Sie, dass ein Objekt, das das Ereignis repräsentiert, als erstes Argument an den Ereignis-Handler übergeben wird. Dieses Ereignis-Objekt implementiert entweder die Event-Schnittstelle oder leitet sich davon ab.

Die flexibelste Methode, um einen Ereignis-Handler auf einem Element zu setzen, ist die Verwendung der Methode EventTarget.addEventListener. Dieser Ansatz erlaubt es, mehrere Listener einem Element zuzuweisen und Listener bei Bedarf zu entfernen (unter Verwendung von EventTarget.removeEventListener).

Unten zeigen wir, wie eine greet()-Funktion als Listener/Ereignis-Handler für das click-Ereignis festgelegt werden kann (statt einer benannten Funktion könnte auch ein anonymer Funktionsausdruck verwendet werden). Beachten Sie erneut, dass das Ereignis als erstes Argument an den Ereignis-Handler übergeben wird.

const btn = document.querySelector("button");

function greet(event) {
  console.log("greet:", event);
}

btn.addEventListener("click", greet);

Die Methode kann auch zusätzliche Argumente/Optionen annehmen, um Aspekte der Erfassung und Entfernung von Ereignissen zu steuern. Weitere Informationen finden Sie auf der Referenzseite EventTarget.addEventListener.

Verwendung eines Abbruchsignals

Eine bemerkenswerte Funktion der Ereignis-Listener ist die Möglichkeit, ein Abbruchsignal zu verwenden, um mehrere Ereignis-Handler gleichzeitig zu bereinigen.

Dies geschieht, indem das gleiche AbortSignal an den Wert von addEventListener() für alle Ereignis-Handler übergeben wird, die Sie zusammen entfernen möchten. Dann können Sie abort() auf dem Controller aufrufen, dem das AbortSignal gehört, und es werden alle Ereignis-Handler entfernt, die mit diesem Signal hinzugefügt wurden. Um beispielsweise einen Ereignis-Handler hinzuzufügen, den wir mit einem AbortSignal entfernen können:

const controller = new AbortController();

btn.addEventListener(
  "click",
  (event) => {
    console.log("greet:", event);
  },
  { signal: controller.signal },
); // pass an AbortSignal to this handler

Dann kann der durch den obigen Code erstellte Ereignis-Handler so entfernt werden:

controller.abort(); // removes any/all event handlers associated with this controller