HTML-DOM removeEventListener()Methode

Document 对象参考手册Dokumentobjekt

Beispiel

Entfernen Sie das durch die addEventListener()-Methode hinzugefügte "mousemove"-Ereignis:

// Event-Handler zum Dokument hinzufügen
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

document.removeEventListener(event, function, useCapture)

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:
  • true - Der Event-Handler wird in der Capturing-Phase entfernt
  • false - Standard. Der Event-Handler wird in der Bubbling-Phase entfernt
Hinweis:Wenn Sie den Event-Handler zweimal hinzufügen, einmal in der Capturing-Phase und einmal in der Bubbling-Phase, müssen Sie jeden einzeln entfernen.

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 (document.removeEventListener) { // Alle Browser, außer IE 8 und älter
    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()


Document 对象参考手册Dokumentobjekt

Andere Erweiterungen