Méthode removeEventListener()du DOM HTML
Exemples
Supprimez l'événement "mousemove" ajouté par la méthode addEventListener() :
document.getElementById("myDIV").addEventListener("mousemove", myFunction);
// Supprimer le gestionnaire d'événement de l'élément <div>
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);
Essayez-le vous-même »
Définition et utilisation
La méthode removeEventListener() est utilisée pour supprimer leaddEventListener()gestionnaire d'événement ajouté par la méthode.
Remarque :Si vous souhaitez supprimer un gestionnaire d'événement, la fonction exécutée par 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é.
Prise en charge des navigateurs
Les nombres dans le tableau spécifient la première version de navigateur qui prend entièrement 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 non plus en charge. Cependant, pour ces navigateurs qui ne prennent pas en charge cette fonction, vous pouvez utiliserdetachEvent()méthode pour supprimer un gestionnaire d'événement 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, vous pouvez consulter 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 de suppression du 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 :
if (x.removeEventListener) { // // Tous les navigateurs, sauf IE 8 et les versions IE antérieures
x.removeEventListener("mousemove", myFunction);
} else if (x.detachEvent) { // IE 8 et versions IE antérieures
x.detachEvent("onmousemove", myFunction);
}
Essayez-le vous-même »
Pages associées
Tutoriel JavaScript :HTML DOM EventListener
Référence JavaScript :document.removeEventListener()
Autres extensions
Objet Element