HTML-DOM removeEventListener()Methode

元素对象参考手册Element-Objekt

Beispiele

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

// Fügen Sie dem <div>-Element einen Ereignishandler hinzu
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

element.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 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:
  • true - Event-Handler in der Capture-Phase entfernen
  • false - Standard. Event-Handler in der Bubble-Phase entfernen
Hinweis:Wenn Sie den Event-Handler zweimal hinzugefügt haben, einmal in der Capture-Phase und einmal in der Bubble-Phase, müssen Sie das Ereignis separat 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:

var x = document.getElementById("myDIV");
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()


元素对象参考手册Element-Objekt

Andere Erweiterungen