JavaScript HTML DOM EventListener


addEventListener()-Methode

Beispiel

Lösen Sie ein Listener-Ereignis aus, wenn der Benutzer auf die Schaltfläche klickt:

document.getElementById("myBtn").addEventListener("click", displayDate);

Selbst ausprobieren »

Die addEventListener()-Methode wird verwendet, um einem angegebenen Element einen Event-Handler hinzuzufügen.

Mit der addEventListener()-Methode hinzugefügte Event-Handler überschreiben keine vorhandenen Event-Handler.

Sie können einem Element mehrere Event-Handler hinzufügen.

Sie können demselben Element mehrere Event-Handler desselben Typs hinzufügen, z. B. zwei "click"-Ereignisse.

Sie können Event-Listener zu jedem DOM-Objekt hinzufügen, nicht nur zu HTML-Elementen. Zum Beispiel: das window-Objekt.

Die addEventListener()-Methode erleichtert die Steuerung von Events (Bubbling vs. Capturing).

Bei Verwendung der addEventListener()-Methode wird JavaScript vom HTML-Markup getrennt, was die Lesbarkeit verbessert, und Sie können Event-Listener auch dann hinzufügen, wenn Sie das HTML-Markup nicht kontrollieren.

Mit der removeEventListener()-Methode können Sie Event-Listener entfernen.


Syntax

element.addEventListener(event, function, useCapture);

Der erste Parameter ist der Typ des Events (wie "click" oder "mousedown").

Der zweite Parameter ist die Funktion, die aufgerufen wird, wenn das Event ausgelöst wird.

Der dritte Parameter ist ein boolescher Wert, der beschreibt, ob das Event Bubbling oder Capturing verwendet. Dieser Parameter ist optional.

Note Hinweis: Verwenden Sie nicht das Präfix "on". Verwenden Sie beispielsweise "click" statt "onclick".


Event-Handler zu einem Element hinzufügen

Beispiel

Zeigen Sie "Hello World!" an, wenn der Benutzer auf ein Element klickt:

element.addEventListener("click", function(){ alert("Hello World!"); });

Selbst ausprobieren »

Sie können auf eine externe Funktion verweisen, indem Sie ihren Funktionsnamen verwenden:

Beispiel

Zeigen Sie "Hello World!" an, wenn der Benutzer auf ein Element klickt:

element.addEventListener("click", myFunction);

function myFunction() {
    alert ("Hello World!");
}

Selbst ausprobieren »


Mehrere Event-Handler zum selben Element hinzufügen

Mit der Methode addEventListener() können Sie mehrere Ereignisse zum selben Element hinzufügen, ohne vorhandene Ereignisse zu überschreiben:

Beispiel

element.addEventListener("click", myFunction);
element.addEventListener("click", mySecondFunction);

Selbst ausprobieren »

Sie können verschiedene Arten von Ereignissen zum selben Element hinzufügen:

Beispiel

element.addEventListener("mouseover", myFunction);
element.addEventListener("click", mySecondFunction);
element.addEventListener("mouseout", myThirdFunction);

Selbst ausprobieren »


Einen Event-Handler zum Window-Objekt hinzufügen

Mit der Methode addEventListener() können Sie Event-Listener zu HTML-DOM-Objekten hinzufügen, wie HTML-Elemente, HTML-Dokumente und das window-Objekt. Oder andere unterstützte Event-Objekte wie das xmlHttpRequest-Objekt.

Beispiel

Fügen Sie einen Event-Listener hinzu, wenn der Benutzer die Fenstergröße ändert:

window.addEventListener("resize", function(){
    document.getElementById("demo").innerHTML = sometext;
});

Selbst ausprobieren »


Parameter übergeben

Wenn Sie Parameterwerte übergeben, verwenden Sie eine "anonyme Funktion", um eine Funktion mit Parametern aufzurufen:

Beispiel

element.addEventListener("click", function(){ myFunction(p1, p2); });

Selbst ausprobieren »


Event-Bubbling oder Event-Capturing?

Es gibt zwei Arten der Event-Propagation: Bubbling und Capturing.

Die Event-Propagation definiert die Reihenfolge, in der Elementereignisse ausgelöst werden. Wenn Sie ein <p>-Element in ein <div>-Element einfügen und der Benutzer auf das <p>-Element klickt, welches Element löst zuerst sein "click"-Ereignis aus?

BeimBubblingBeim Bubbling wird das Ereignis des inneren Elements zuerst ausgelöst und dann wird das äußere Element ausgelöst. Das heißt: Das Klick-Ereignis des <p>-Elements wird zuerst ausgelöst, dann das Klick-Ereignis des <div>-Elements.

BeimCapturingBeim Capturing wird das Ereignis des äußeren Elements zuerst ausgelöst und dann wird das Ereignis des inneren Elements ausgelöst. Das heißt: Das Klick-Ereignis des <div>-Elements wird zuerst ausgelöst, dann das Klick-Ereignis des <p>-Elements.

Die addEventListener()-Methode kann den Parameter "useCapture" angeben, um den Propagationstyp festzulegen:

addEventListener(event, function, useCapture);

Der Standardwert ist false, was Bubbling-Propagation bedeutet. Wenn der Wert true ist, verwendet das Ereignis Capturing-Propagation.

Beispiel

document.getElementById("myDiv").addEventListener("click", myFunction, true);

Selbst ausprobieren »


removeEventListener()-Methode

Die removeEventListener()-Methode entfernt Event-Handler, die durch die addEventListener()-Methode hinzugefügt wurden:

Beispiel

element.removeEventListener("mousemove", myFunction);

Selbst ausprobieren »


Browser-Unterstützung

Die Zahlen in der Tabelle geben die erste Browserversion an, die die Methode vollständig unterstützt.

Methode
addEventListener() 1.0 9.0 1.0 1.0 7.0
removeEventListener() 1.0 9.0 1.0 1.0 7.0

Hinweis:IE 8 und frühere IE-Versionen sowie Opera 7.0 und frühere Versionen unterstützen die Methoden addEventListener() und removeEventListener() nicht. Für diese Browserversionen können Sie jedoch die detachEvent()-Methode verwenden, um Event-Handler zu entfernen:

element.attachEvent(event, function);
element.detachEvent(event, function);

Beispiel

Browserübergreifende Lösung:

var x = document.getElementById("myBtn");
if (x.addEventListener) { // Alle gängigen Browser, außer IE 8 und früher
    x.addEventListener("click", myFunction);
} else if (x.attachEvent) { // IE 8 und frühere Versionen
    x.attachEvent("onclick", myFunction);
}

Selbst ausprobieren »


HTML-DOM-Ereignisobjekt-Referenz

Für alle HTML-DOM-Ereignisse können Sie unsere vollständigeHTML-DOM-Ereignisobjekt-Referenzeinsehen。 Andere Erweiterungen