HTML-DOM-Dokument removeEventListener()
Beispiel
Entfernen Sie ein "mousemove"-Ereignis, das mit der Methode addEventListener() angehängt wurde:
// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);
Weitere „Probieren Sie es selbst“-Beispiele weiter unten.
Definition und Verwendung
Die Methode document.removeEventListener() entfernt einen Event-Handler, der mit der Methode document.addEventListener() angehängt wurde .
Hinweis: Um Event-Handler zu entfernen, muss die mit der addEventListener()-Methode angegebene Funktion eine externe, „benannte“ Funktion sein, wie im obigen Beispiel (myFunction).
Anonyme Funktionen wie "document.removeEventListener(" event ", function(){ myScript });" wird nicht funktionieren.
Tipp: Verwenden Sie die Methoden element .addEventListener() und element .removeEventListener() , um Event-Handler zu/von einem angegebenen Element hinzuzufügen/zu entfernen.
Syntax
document.removeEventListener(event, function, useCapture)
Parameterwerte
Parameter | Description |
---|---|
event | Required. A String that specifies the name of the event to remove. Note: Do not use the "on" prefix. For example, use "click" instead of "onclick". Tip: For a list of all HTML DOM events, look at our complete HTML DOM Event Object Reference. |
function | Required. Specifies the function to remove. |
useCapture |
Optional. A Boolean value that specifies the event phase
to remove the event handler from. Possible values:
|
Technische Details
DOM-Version: | DOM-Level-2-Ereignisse |
---|---|
Rückgabewert: | Kein Rückgabewert |
Änderungsprotokoll: | Der Parameter useCapture wurde in Firefox 6 und Opera 12.0 optional (war immer optional für Chrome, IE und Safari) |
Mehr Beispiele
Beispiel
Für Browser, die die Methode removeEventListener() nicht unterstützen, können Sie die Methode resolveEvent() verwenden.
Dieses Beispiel zeigt eine Cross-Browser-Lösung:
if (document.removeEventListener) { // For all major browsers, except IE 8 and earlier
document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) { // For IE 8 and earlier versions
document.detachEvent("onmousemove", myFunction);
}
Verwandte Seiten
JavaScript-Tutorial: HTML-DOM-EventListener
JavaScript-Referenz: element .removeEventListener()
Browser-Unterstützung
document.removeEventListener()
ist eine Funktion von DOM Level 2 (2001).
Es wird in allen Browsern vollständig unterstützt:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |