HTML DOM addEventListener()Methode
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("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
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:
|
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:
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", 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("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:
myFunction(p1, p2);
});
Selbst ausprobieren »
Beispiel
Ändern Sie den Hintergrund eines <button>-Elements:
this.style.backgroundColor = "red";
});
Selbst ausprobieren »
Beispiel
Verwenden Sie den optionalen ParameteruseCapture, um den Unterschied zwischen Bubbling- und Capturing-Phase zu demonstrieren:
Selbst ausprobieren »
Beispiel
Verwenden Sie die removeEventListener()-Methode, um einen durch die addEventListener()-Methode hinzugefügten Event-Handler zu entfernen:
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:
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()
Andere Erweiterungen
Element-Objekt