Beispiel
Entfernen ein "mousemove" Ereignis , das mit der beigefügten wurde addEventListener() Methode:
// Attach an event handler to the document
document.addEventListener("mousemove",
myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction); Versuch es selber " Mehr "Try it Yourself" Sie "Try it Yourself" Beispiele unten.
Definition und Verwendung
Das document. removeEventListener() document. removeEventListener() Methode entfernt einen Ereignis - Handler, der mit dem daran befestigten wurde Dokument. addEventListener() Methode.
Hinweis: Um die Event - Handler zu entfernen, wird die Funktion mit der angegebenen addEventListener() Methode muss eine externen sein, "named" Funktion, wie im Beispiel oben (myFunction) .
Anonyme Funktionen, wie "Dokument. removeEventListener(" event ", function() {myScript});" wird nicht funktionieren.
Tipp: Verwenden Sie das Element. addEventListener() und Element. removeEventListener() Verfahren zum Hinzufügen / Entfernen Event - Handler zu / von einem bestimmten Elemente.
Browser-Unterstützung
Die Zahlen in der Tabelle geben Sie die erste Browser-Version, die die Methode vollständig unterstützt.
| Methode | |||||
|---|---|---|---|---|---|
| removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Hinweis: Die removeEventListener() Methode wird nicht unterstützt in Internet Explorer 8 und früheren Versionen und Opera 6.0 und früheren Versionen. Doch für diese speziellen Browser - Versionen, können Sie die Verwendung detachEvent() Methode , um Event - Handler zu entfernen , die mit der beigefügten wurden attachEvent() Methode (siehe "More Examples" unten für eine Cross-Browser - Lösung).
Syntax
document.removeEventListener( event , function ,
useCapture )
Parameterwerte
| Parameter | Beschreibung |
|---|---|
| event | Erforderlich. Ein String, der den Namen des Ereignisses angibt, zu entfernen. Hinweis: Die nicht verwenden "on" Präfix. Verwenden Sie zum Beispiel "click" statt "onclick" . Tipp: Eine Liste aller Ereignisse HTML - DOM, einen Blick auf unsere komplette HTML - DOM Event - Objekt Referenz . |
| function | Erforderlich. Gibt die Funktion zu entfernen. |
| useCapture | Optional. Ein boolescher Wert, den das Ereignis Phase gibt an, von den Event-Handler zu entfernen. Mögliche Werte:
|
Technische Details
| DOM Version: | DOM Level 2 Veranstaltungen |
|---|---|
| Rückgabewert: | Kein Rückgabewert |
| Änderungsprotokoll: | Der Parameter useCapture wurde optional in Firefox 6 und Opera 12.0 (has always been optional for Chrome, IE and Safari) |
Mehr Beispiele
Beispiel
Für Browser , die das nicht unterstützen removeEventListener() Methode können Sie die Verwendung detachEvent() Methode.
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);
} Versuch es selber " Verwandte Seiten
JavaScript Tutorial: HTML DOM Eventlistener
JavaScript Referenz: Element. removeEventListener()