HTML DOM-document removeEventListener()
Voorbeeld
Verwijder een "mousemove"-gebeurtenis die is gekoppeld met de addEventListener()-methode:
// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);
Meer "Probeer het zelf" voorbeelden hieronder.
Definitie en gebruik
De methode document.removeEventListener() verwijdert een gebeurtenishandler die is gekoppeld aan de methode document.addEventListener() .
Opmerking: om gebeurtenishandlers te verwijderen, moet de functie die is opgegeven met de methode addEventListener() een externe "named"-functie zijn, zoals in het bovenstaande voorbeeld (myFunction).
Anonieme functies, zoals "document.removeEventListener(" event ", function(){ myScript });" zal niet werken.
Tip: gebruik de methoden element .addEventListener() en element .removeEventListener() om gebeurtenishandlers toe te voegen aan/te verwijderen van een opgegeven element.
Syntaxis
document.removeEventListener(event, function, useCapture)
Parameterwaarden
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-versie: | DOM Level 2-evenementen |
---|---|
Winstwaarde: | Geen retourwaarde |
Wijzigingslogboek: | De parameter useCapture werd optioneel in Firefox 6 en Opera 12.0 (is altijd optioneel geweest voor Chrome, IE en Safari) |
Meer voorbeelden
Voorbeeld
Voor browsers die de methode removeEventListener() niet ondersteunen, kunt u de methode detachEvent() gebruiken.
Dit voorbeeld demonstreert een oplossing voor meerdere browsers:
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);
}
Gerelateerde pagina's
JavaScript-zelfstudie: HTML DOM EventListener
JavaScript-referentie: element .removeEventListener()
Browserondersteuning
document.removeEventListener()
is een DOM Level 2 (2001)-functie.
Het wordt volledig ondersteund in alle browsers:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |