Méthode removeEventListener()du DOM HTML
Exemple
Supprimez l'événement "mousemove" ajouté par la méthode addEventListener() :
document.addEventListener("mousemove", myFunction);
// Supprimer le gestionnaire d'événement du document
document.removeEventListener("mousemove", myFunction);
Essayez-le vous-même »
Définition et utilisation
La méthode document.removeEventListener() est utilisée pour supprimer le gestionnaire d'événement ajouté par la méthodedocument.addEventListener().
Remarque :Pour supprimer un gestionnaire d'événement, la fonction passée à addEventListener() doit être une fonction externe, comme montré dans l'exemple ci-dessus (myFunction).
Les fonctions anonymes, comme "document.removeEventListener("event", function(){ myScript});" l'événement ne peut pas être supprimé.
Astuce :Utilisez la element.addEventListener()etelement.removeEventListener()méthode pour ajouter ou supprimer des gestionnaires d'événements pour l'élément spécifié.
Prise en charge des navigateurs
Les nombres dans le tableau indiquent la première version du navigateur qui prend en charge la méthode.
| Méthode | |||||
|---|---|---|---|---|---|
| removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Remarque :Internet Explorer 8 et les versions IE antérieures ne prennent pas en charge la méthode removeEventListener(), et Opera 7.0 et les versions antérieures d'Opera ne la prennent pas en charge non plus. Toutefois, pour ces navigateurs qui ne prennent pas en charge cette fonction, vous pouvez utiliser ladetachEvent()méthode pour supprimer le gestionnaire d'événements ajouté par la méthode attachEvent() (voir « Plus d'exemples » pour une solution multi-navigateurs).
Syntaxe
Valeurs des paramètres
| Paramètre | Description |
|---|---|
| event | Obligatoire. Le nom de l'événement à supprimer. Remarque :N'utilisez pas le préfixe "on". Par exemple, utilisez "click" au lieu de "onclick". Astuce :Pour tous les événements HTML DOM, consultez notre référence complète des objets d'événements HTML DOM. |
| fonction | Obligatoire. Spécifie la fonction à supprimer. |
| useCapture | Facultatif. Une valeur booléenne qui spécifie la phase dans laquelle supprimer le gestionnaire d'événements. Valeurs possibles :
|
Détails techniques
| Version DOM : | Événements DOM Level 2 |
|---|---|
| Valeur de retour : | Aucune valeur de retour |
| Journal des modifications : | Dans Firefox 6 et Opera 12.0, le paramètre useCapture est facultatif. (Il a toujours été facultatif dans Chrome, IE et Safari). |
Plus d’exemples
Exemple
Si le navigateur ne prend pas en charge la méthode removeEventListener(), vous pouvez utiliser la méthode detachEvent() à la place.
Cet exemple démontre une solution multi-navigateurs :
document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) { // IE 8 et versions antérieures
document.detachEvent("onmousemove", myFunction);
}
Essayez-le vous-même »
Articles connexes
Tutoriel JavaScript :HTML DOM EventListener
Référence JavaScript :element.removeEventListener()
Autres extensions
Objet Document