HTML DOM addEventListener()Methode

Document 对象参考手册Dokumentobjekt

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:

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

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

document.addEventListener(event, function, useCapture)

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:
  • 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
Ä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:

document.addEventListener("click", myFunction);

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", myFunction);
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("mouseover", myFunction);
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:

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

Selbst ausprobieren »

Beispiel

Ändern Sie den Hintergrund des <body>-Elements:

document.addEventListener("click", function(){
    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:

// Fügen Sie einen Event-Handler zum Dokument hinzu
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:

if (document.addEventListener) { // Alle wichtigen Browser, außer IE 8 und früheren IE-Versionen
    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()

Document 对象参考手册Dokumentobjekt

Andere Erweiterungen