HTML DOM addEventListener()Methode
Beispiel
Fügen Sie dem Dokument ein Click-Event hinzu. Wenn der Benutzer irgendwo im Dokument klickt, geben Sie "Hello World" auf dem <p>-Element mit id="demo" aus:
Selbst ausprobieren »
Definition und Verwendung
Die Methode document.addEventListener() wird verwendet, um einen Event-Handler zum Dokument hinzuzufügen.
Tipp:Sie können die document.removeEventListener()Methode, um den Event-Handler zu entfernen, der von der addEventListener()-Methode hinzugefügt wurde.
Tipp:Verwenden Sie die element.addEventListener()Methode, um einen Event-Handler zum angegebenen Element hinzuzufügen.
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 addEventListener()-Methode nicht, und Opera 7.0 und frühere Opera-Versionen unterstützen sie ebenfalls nicht. Für solche Browserversionen können Sie jedoch dieattachEvent()Methode zum Hinzufügen von Event-Handlern (für Cross-Browser-Kompatibilitätsprobleme siehe "Weitere Beispiele").
Syntax
Parameterwerte
| Parameter | Beschreibung |
|---|---|
| event | Erforderlich. Ein String, der den Namen des Ereignisses angibt. Hinweis:Verwenden Sie nicht das Präfix "on". Zum Beispiel verwenden Sie "click" anstelle von "onclick". Tipp:Eine vollständige Übersicht über alle HTML-DOM-Ereignisse finden Sie in unserem vollständigenHTML-DOM-Ereignisobjekt-Referenzhandbuch。 |
| Funktion | Erforderlich. Beschreibt die Funktion, die ausgeführt wird, wenn das Ereignis ausgelöst wird. Wenn das Ereignis ausgelöst wird, wird das Ereignisobjekt als erster Parameter an die Funktion übergeben. Der Typ des Ereignisobjekts hängt vom jeweiligen Ereignis ab. Zum Beispiel gehört das "click"-Ereignis zum MouseEvent-Objekt. |
| useCapture | Optional. Ein boolescher Wert, der angibt, ob das Ereignis in der Capturing- oder Bubbling-Phase ausgeführt wird. Mögliche Werte:
|
Technische Details
| DOM-Version: | DOM Level 2 Events |
|---|---|
| Rückgabewert: | Kein Rückgabewert |
| Änderungsprotokoll: | Der Parameter useCapture ist in Firefox 6 und Opera 11.60 optional. (Er war in Chrome, IE und Safari schon immer optional). |
Weitere Beispiele
Beispiel
Sie können eine externe Funktion über ihren Namen referenzieren:
function myFunction() {
document.getElementById("demo").innerHTML = "Hello World";
}
Selbst ausprobieren »
Beispiel
Sie können dem Dokument viele Ereignisse hinzufügen, und die hinzugefügten Ereignisse überschreiben keine vorhandenen Ereignisse.
Dieses Beispiel zeigt, wie Sie dem Dokument zwei Klick-Ereignisse hinzufügen:
document.addEventListener("click", someOtherFunction);
Selbst ausprobieren »
Beispiel
Sie können dem Dokument verschiedene Arten von Ereignissen hinzufügen.
Dieses Beispiel zeigt, wie Sie dem Dokument mehrere Ereignisse hinzufügen:
document.addEventListener("click", someOtherFunction);
document.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 des <body>-Elements:
document.body.style.backgroundColor = "red";
});
Selbst ausprobieren »
Beispiel
Verwenden Sie die removeEventListener()-Methode, um einen durch die addEventListener()-Methode hinzugefügten Event-Handler zu entfernen:
document.addEventListener("mousemove", myFunction);
// Entfernen Sie den Event-Handler des Dokuments
document.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:
document.addEventListener("click", myFunction);
} else if (document.attachEvent) { // IE 8 und frühere IE-Versionen
document.attachEvent("onclick", myFunction);
}
Selbst ausprobieren »
Verwandte
JavaScript-Tutorial:HTML DOM EventListener
JavaScript-Referenzhandbuch:element.addEventListener()
Andere Erweiterungen
Dokumentobjekt