HTML-DOM removeEventListener()Methode
Beispiele
Entfernen Sie das durch die addEventListener()-Methode hinzugefügte "mousemove"-Ereignis:
document.getElementById("myDIV").addEventListener("mousemove", myFunction);
// Entfernen Sie den Ereignishandler aus dem <div>-Element
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);
Selbst ausprobieren »
Definition und Verwendung
Die removeEventListener()-Methode wird verwendet, um den durch die MethodeaddEventListener()hinzugefügten Ereignishandler zu entfernen.
Hinweis:Wenn Sie einen Ereignishandler entfernen möchten, muss die von addEventListener() ausgeführte Funktion eine externe Funktion sein, wie im obigen Beispiel gezeigt (myFunction).
Anonyme Funktionen wie "document.removeEventListener("event", function(){ myScript});" Das Ereignis kann nicht entfernt werden.
Browser-Unterstützung
Die Zahlen in der Tabelle geben die erste Browserversion an, die die Methode vollständig 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 Methode removeEventListener() 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 jedochdetachEvent()-Methode verwenden, um einen Ereignishandler zu entfernen, 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 können Sie unsere vollständige HTML-DOM-Event-Objekt-Referenz anzeigen. |
| Funktion | Erforderlich. Gibt die zu entfernende Funktion an. |
| useCapture | Optional. Ein boolescher Wert, der die Phase zum Entfernen des Event-Handlers angibt. 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:
if (x.removeEventListener) { // // Alle Browser, außer IE 8 und früheren IE-Versionen
x.removeEventListener("mousemove", myFunction);
} else if (x.detachEvent) { // IE 8 und frühere IE-Versionen
x.detachEvent("onmousemove", myFunction);
}
Selbst ausprobieren »
Verwandte
JavaScript-Tutorial:HTML DOM EventListener
JavaScript-Referenz:document.removeEventListener()
Andere Erweiterungen
Element-Objekt