HTML DOM addEventListener()Methode

元素对象参考手册Element-Objekt

Beispiel

Fügen Sie einem <button>-Element ein Klick-Ereignis hinzu. Wenn der Benutzer auf die Schaltfläche klickt, geben Sie "Hello World" in einem <p>-Element mit id="demo" aus:

document.getElementById("myBtn").addEventListener("click", function(){
    document.getElementById("demo").innerHTML = "Hello World";
});

Selbst ausprobieren »

Definition und Verwendung

Die Methode addEventListener() wird verwendet, um einen Event-Handler an das angegebene Element anzuhängen.

Tipp:Verwenden SieremoveEventListener(), die Methode, um einen Event-Handler zu entfernen, der durch die Methode addEventListener() hinzugefügt wurde.


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

Hinweis:Internet Explorer 8 und frühere IE-Versionen unterstützen die Methode addEventListener() nicht, und Opera 7.0 und frühere Versionen von Opera unterstützen sie ebenfalls nicht. Für diese Browser, die diese Funktion nicht unterstützen, können Sie jedochattachEvent()die Methode zum Hinzufügen eines Event-Handlers (siehe "Weitere Beispiele" für eine browserübergreifende Lösung).


Syntax

element.addEventListener(event, function, useCapture)

Parameterwerte

Parameter Beschreibung
event Erforderlich. Eine Zeichenfolge, die den Ereignisnamen angibt.

Hinweis:Verwenden Sie nicht das Präfix "on". Zum Beispiel verwenden Sie "click" anstelle von "onclick".

Tipp:Für alle HTML-DOM-Ereignisse können Sie unsere vollständigeHTML-DOM-Ereignisobjekt-Referenz anzeigen。
Funktion Erforderlich. Gibt die Funktion an, die ausgeführt wird, wenn das Ereignis ausgelöst wird.

Wenn das Ereignisobjekt als erster Parameter an die Funktion übergeben wird. Der Typ des Ereignisobjekts hängt vom jeweiligen Ereignis ab. Beispielsweise gehört das "click"-Ereignis zum MouseEvent-Objekt.
useCapture Optional. Ein boolescher Wert, der angibt, ob das Ereignis in der Erfassungs- oder Bubbling-Phase ausgeführt werden soll.

Mögliche Werte:
  • true - Der Ereignishandler wird in der Capturing-Phase ausgeführt
  • false - Standard. Der Ereignishandler wird in der Bubbling-Phase ausgeführt

Technische Details

DOM-Version: DOM Level 2 Events
Rückgabewert: Kein Rückgabewert
Notizen: In Firefox 6 und Opera 11.60 ist der Parameter useCapture optional. (In Chrome, IE und Safari war er schon immer optional).


Weitere Beispiele

Beispiel

Sie können eine externe Funktion über ihren Namen referenzieren.

Dieses Beispiel zeigt, wie man eine Funktion ausführt, wenn der Benutzer auf ein <button>-Element klickt:

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

function myFunction() {
    document.getElementById("demo").innerHTML = "Hello World";
}

Selbst ausprobieren »

Beispiel

Sie können dem Dokument viele Ereignisse hinzufügen; die hinzugefügten Ereignisse überschreiben keine vorhandenen Ereignisse.

Dieses Beispiel zeigt, wie man zwei Klick-Ereignisse zu einem <button>-Element hinzufügt:

document.getElementById("myBtn").addEventListener("click", myFunction);
document.getElementById("myBtn").addEventListener("click", someOtherFunction);

Selbst ausprobieren »

Beispiel

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

Dieses Beispiel zeigt, wie man mehrere Ereignisse zum selben <button>-Element hinzufügt:

document.getElementById("myBtn").addEventListener("mouseover", myFunction);
document.getElementById("myBtn").addEventListener("click", someOtherFunction);
document.getElementById("myBtn").addEventListener("mouseout", someOtherFunction);

Selbst ausprobieren »

Beispiel

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

document.getElementById("myBtn").addEventListener("click", function() {
    myFunction(p1, p2);
});

Selbst ausprobieren »

Beispiel

Ändern Sie den Hintergrund eines <button>-Elements:

document.getElementById("myBtn").addEventListener("click", function(){
    this.style.backgroundColor = "red";
});

Selbst ausprobieren »

Beispiel

Verwenden Sie den optionalen ParameteruseCapture, um den Unterschied zwischen Bubbling- und Capturing-Phase zu demonstrieren:

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

Selbst ausprobieren »

Beispiel

Verwenden Sie die removeEventListener()-Methode, um einen durch die addEventListener()-Methode hinzugefügten Event-Handler zu entfernen:

// <div>-Ereignishandler hinzufügen
document.getElementById("myDIV").addEventListener("mousemove", myFunction);

// <div>-Ereignishandler entfernen
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);

Selbst ausprobieren »

Beispiel

Wenn der Browser die Methode addEventListener() nicht unterstützt, können Sie stattdessen die Methode attachEvent() verwenden.

Das folgende Beispiel veranschaulicht eine browserübergreifende Lösung:

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

Selbst ausprobieren »


Verwandte

JavaScript-Tutorial:HTML DOM EventListener

JavaScript-Referenz:document.addEventListener()


元素对象参考手册Element-Objekt

Andere Erweiterungen