HTML-DOM removeEventListener()Methode
Beispiel
Entfernen Sie das durch die addEventListener()-Methode hinzugefügte "mousemove"-Ereignis:
document.addEventListener("mousemove", myFunction);
// Event-Handler aus dem Dokument entfernen
document.removeEventListener("mousemove", myFunction);
Selbst ausprobieren »
Definition und Verwendung
Die Methode document.removeEventListener() wird verwendet, umdocument.addEventListener()den von der Methode hinzugefügten Event-Handler zu entfernen.
Hinweis:Um einen Event-Handler zu entfernen, muss die an addEventListener() übergebene Funktion eine externe Funktion sein, wie im obigen Beispiel gezeigt (myFunction).
Anonyme Funktionen, wie "document.removeEventListener("event", function(){ myScript});" kann das Ereignis nicht entfernt werden.
Tipp:Verwenden Sie die element.addEventListener()undelement.removeEventListener()-Methode zum Hinzufügen oder Entfernen von Event-Handlern für das angegebene Element.
Browser-Unterstützung
Die Zahlen in der Tabelle geben die erste Browserversion an, die die Methode unterstützt.
| Methode | |||||
|---|---|---|---|---|---|
| removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Hinweis:Internet Explorer 8 und frühere IE-Versionen unterstützen die removeEventListener()-Methode nicht, und Opera 7.0 und frühere Opera-Versionen unterstützen sie ebenfalls nicht. Für diese Browser, die diese Funktion nicht unterstützen, können Sie jedoch diedetachEvent()-Methode zum Entfernen des Event-Handlers, der durch die attachEvent()-Methode hinzugefügt wurde (siehe "Weitere Beispiele" für eine browserübergreifende Lösung).
Syntax
Parameterwerte
| Parameter | Beschreibung |
|---|---|
| event | Erforderlich. Der Name des zu entfernenden Ereignisses. Hinweis:Verwenden Sie nicht das Präfix "on". Zum Beispiel verwenden Sie "click" anstelle von "onclick". Tipp:Für alle HTML-DOM-Ereignisse siehe unsere vollständige HTML DOM Event Object Reference。 |
| Funktion | Erforderlich. Gibt die zu entfernende Funktion an. |
| useCapture | Optional. Ein boolescher Wert, der die Phase angibt, in der der Event-Handler entfernt wird. Mögliche Werte:
|
Technische Details
| DOM-Version: | DOM Level 2-Ereignisse |
|---|---|
| Rückgabewert: | Kein Rückgabewert |
| Änderungsprotokoll: | In Firefox 6 und Opera 12.0 ist der Parameter useCapture optional. (In Chrome, IE und Safari war er schon immer optional). |
Weitere Beispiele
Beispiel
Wenn der Browser die Methode removeEventListener() nicht unterstützt, können Sie stattdessen die Methode detachEvent() verwenden.
Dieses Beispiel demonstriert eine browserübergreifende Lösung:
document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) { // IE 8 und älter
document.detachEvent("onmousemove", myFunction);
}
Selbst ausprobieren »
Ähnliche Artikel
JavaScript-Tutorial:HTML DOM EventListener
JavaScript-Referenz:element.removeEventListener()
Andere Erweiterungen
Dokumentobjekt