Document HTML DOM removeEventListener()
Exemple
Supprimez un événement "mousemove" qui a été attaché avec la méthode addEventListener() :
// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);
// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);
Plus d'exemples "Essayez-le vous-même" ci-dessous.
Définition et utilisation
La méthode document.removeEventListener() supprime un gestionnaire d'événements qui a été attaché avec la méthode document.addEventListener() .
Remarque : Pour supprimer des gestionnaires d'événements, la fonction spécifiée avec la méthode addEventListener() doit être une fonction externe "nommée", comme dans l'exemple ci-dessus (myFunction).
Fonctions anonymes, comme "document.removeEventListener(" event ", function(){ myScript });" ne fonctionnera pas.
Conseil : utilisez les méthodes element .addEventListener() et element .removeEventListener() pour ajouter/supprimer des gestionnaires d'événements à/d'un élément spécifié.
Syntaxe
document.removeEventListener(event, function, useCapture)
Valeurs des paramètres
| 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:
|
Détails techniques
| Version DOM : | Événements DOM niveau 2 |
|---|---|
| Valeur de retour : | Aucune valeur de retour |
| Journal des modifications : | Le paramètre useCapture est devenu facultatif dans Firefox 6 et Opera 12.0 (a toujours été facultatif pour Chrome, IE et Safari) |
Plus d'exemples
Exemple
Pour les navigateurs qui ne prennent pas en charge la méthode removeEventListener(), vous pouvez utiliser la méthode detachEvent().
Cet exemple illustre une solution multi-navigateur :
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);
}
Pages connexes
Tutoriel JavaScript : HTML DOM EventListener
Référence JavaScript : élément .removeEventListener()
Prise en charge du navigateur
document.removeEventListener() est une fonctionnalité DOM niveau 2 (2001).
Il est entièrement pris en charge dans tous les navigateurs :
| Chrome | IE | Edge | Firefox | Safari | Opera |
| Yes | 9-11 | Yes | Yes | Yes | Yes |