mitmario.dev

Das Event-Objekt

JavaScript Im Browser 4 Min Lesezeit 3 BeispieleLektion 2 von 9

Ein Listener an einer Liste soll wissen, welcher Eintrag angeklickt wurde. Ein Feld soll wissen, welche Taste es war. Der Browser ruft den Handler deshalb nicht einfach nur auf, er gibt ihm auch ein Objekt mit, in dem alles steht, was er über das Ereignis weiß.

Ein Argument, das immer da ist

Der Handler bekommt genau ein Argument. Wie es heißt, ist dir überlassen, üblich sind event oder kurz e. Nimmt der Handler es nicht entgegen, wird es trotzdem übergeben und bleibt eben ungenutzt.

Was darin steht, hängt vom Ereignis ab. Ein paar Angaben sind immer dabei. Andere gibt es nur bei Tastatur oder Maus.

Das ganze Objekt auf einmal auszugeben bringt hier wenig. console.log(event) schreibt bei einem Klick PointerEvent {isTrusted: true} in die Console, also den Namen seiner Bauart und eine einzige Eigenschaft. Ein Ereignis trägt seine Angaben nämlich nicht selbst, es erbt sie, und beim Aufklappen zeigt die Console nur, was einem Objekt wirklich gehört.

isTrusted gehört ihm. Daran siehst du, ob ein Mensch das Ereignis ausgelöst hat oder Code, und bei einem button.click() aus der vorigen Lektion steht dort false. Im echten Browser klappt dieselbe Zeile das ganze Ding auf. Hier fragst du einzeln nach, und in den nächsten Absätzen steht, wonach sich das lohnt.

target und currentTarget

target und currentTarget
const liste = document.querySelector(".liste");
const ausgabe = document.getElementById("ausgabe");

// Der Listener hängt an der LISTE. Geklickt wird trotzdem
// das, was unter dem Zeiger liegt.
liste.addEventListener("click", (event) => {
  const zeilen = [
    `type: ${event.type}`,
    `target: ${event.target.tagName} mit Klasse "${event.target.className}"`,
    `currentTarget: ${event.currentTarget.tagName}`,
    `gleich? ${event.target === event.currentTarget}`,
  ];
  ausgabe.textContent = zeilen.join("\n");
  console.log(zeilen.join(" | "));
});

console.log("Ein Klick auf die Liste schreibt target und currentTarget in die Ausgabe.");

Um diese beiden geht es in dieser Lektion eigentlich, und sie sehen sich zum Verwechseln ähnlich.

event.currentTarget ist das Element, an dem der Listener hängt, also das, was beim addEventListener links vom Punkt stand. Das ändert sich nie.

event.target ist das Element, auf dem das Ereignis wirklich passiert ist, also das, was unter dem Zeiger lag.

Solange das Element keine Kinder hat, sind beide gleich. Hat es welche, laufen sie auseinander. Bei einer Liste mit Einträgen und einer Mengenangabe darin ist currentTarget die Liste, und target ist das, was getroffen wurde, beim Klick auf die Menge also das em und beim Klick auf das Wort davor das li.

Das ist kein Fehler, sondern die Grundlage für Bubbling und Event-Delegation weiter hinten in diesem Abschnitt. Ein Ereignis passiert unten und wird oben mitbekommen.

Wo der Listener hängt, steht in currentTarget. Worauf jemand geklickt hat, steht in target.

Type, Taste, Position

Was sonst noch im Ereignis steht
const ausgabe = document.getElementById("ausgabe");

// Bei Tastatur-Ereignissen steht dort, welche Taste es war.
document.getElementById("feld").addEventListener("keydown", (event) => {
  ausgabe.textContent = `Taste: ${event.key}`;
  console.log("key:", event.key, "| Umschalt gedrückt?", event.shiftKey);
});

// Bei Maus-Ereignissen steht dort, wo im Fenster der Zeiger war.
document.getElementById("flaeche").addEventListener("click", (event) => {
  ausgabe.textContent = `Klick bei ${Math.round(event.clientX)}, ${Math.round(event.clientY)}`;
});

// Der Name des Arguments ist frei wählbar. "event" ist üblich,
// "e" sieht man genauso oft. Der Browser übergibt es immer,
// ob du es entgegennimmst oder nicht.
document.getElementById("feld").addEventListener("focus", () => {
  console.log("Ein Handler darf das Ereignis auch ignorieren.");
});

event.type ist der Name des Ereignisses als Text, also "click", "keydown" und so weiter. Das ist praktisch, wenn derselbe Handler an mehreren Ereignissen hängt.

Bei Tastatur-Ereignissen steht in event.key, welche Taste es war, "a", "Enter", "Escape" oder "ArrowLeft". Dazu kommen shiftKey, ctrlKey, altKey und metaKey als Wahrheitswerte für die Sondertasten.

Bei Maus-Ereignissen stehen in event.clientX und event.clientY die Koordinaten des Zeigers im sichtbaren Bereich des Fensters, gemessen in Pixeln von der linken oberen Ecke.

In denselben Pixeln sagt getBoundingClientRect(), wo ein Element liegt. document.getElementById("flaeche").getBoundingClientRect().left antwortet in der Eingabezeile der Console mit 16, .top in der schmalen Spalte mit etwas um 55. Klickst du danach ganz oben links in die Fläche, meldet das Ereignis ein clientX knapp über 16 und ein clientY knapp über 55, Kante und Klick also im selben Maß. Das Rechteck als Ganzes bringt dagegen wenig. getBoundingClientRect() allein antwortet mit DOMRect {}, aus demselben Grund wie das Ereignis oben.

Die Fläche im Beispiel ist ein div und lässt sich nur mit der Maus bedienen, für Koordinaten reicht das. Es gibt noch viel mehr Angaben, und auswendig können musst du davon nichts.

this im Handler

this im Handler, und warum es zwei Antworten gibt
// In einer klassischen Funktion setzt der Browser this auf
// currentTarget, also auf das Element mit dem Listener.
document.getElementById("klassisch").addEventListener("click", function (event) {
  console.log("this ist:", this.tagName, this.id);
  console.log("gleich currentTarget?", this === event.currentTarget);
});

// Eine Arrow Function bringt ihr this von außen mit und
// lässt es sich nicht setzen. Hier oben ist das das Fenster.
document.getElementById("pfeil").addEventListener("click", (event) => {
  console.log("this ist:", this === window ? "window" : this);
  console.log("gleich currentTarget?", this === event.currentTarget);
  console.log("currentTarget aber schon:", event.currentTarget.id);
});

console.log("Ein Klick auf jeden der beiden Buttons zeigt den Unterschied.");

In einer klassischen Funktion setzt der Browser this auf currentTarget. Das ist praktisch, und deshalb steht in älterem Code oft this.classList.add(...).

In einer Arrow Function passiert das nicht. Sie bringt ihr this von dort mit, wo sie geschrieben wurde, und lässt es sich von niemandem setzen. Auf oberster Ebene eines Skripts ist das das Fenster.

Das ist der Unterschied aus Lektion 7.3, nur an einer neuen Stelle. Ich nehme deshalb lieber event.currentTarget, das liefert in beiden Fällen dasselbe. In diesem Kurs stehen Handler als Arrow Function da, und wo das Element gebraucht wird, steht event.currentTarget. Eine Angabe mehr zu tippen, eine Verwechslung weniger.

Das gilt auch für eine herausgelöste Methode. button.addEventListener("click", zaehler.erhoehe) ruft erhoehe mit dem Button als this auf und nicht mit zaehler, und this.stand fragt dann den Button nach einer Eigenschaft, die er gar nicht hat. Eine Arrow Function drumherum, () => zaehler.erhoehe(), ruft die Methode wieder mit dem Punkt auf.

In der Aufgabe liest ein Listener an einer Karte drei Angaben aus einem Klick auf das Symbol darin.

Zum Mitnehmen

Der Handler bekommt das Ereignis als Objekt. target ist das Element, auf dem es passiert ist, currentTarget das, an dem der Listener hängt, und bei einem Element mit Kindern sind das oft zwei verschiedene.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

Was in dieser Lektion steckt

  • Artikel mit 3 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe im Editor, direkt im Browser geprüft

    Öffnet sich mit dem Basis Konto.