HTML DOM removeEventListener() Method

Exemple

Supprimer un "mousemove" événement qui a été attaché à la addEventListener() méthode:

// Attach an event handler to the document
document.addEventListener("mousemove", myFunction);

// Remove the event handler from the document
document.removeEventListener("mousemove", myFunction);

Essayez vous - même »

Plus "Try it Yourself" - "Try it Yourself" exemples ci - dessous.

Définition et utilisation

Le document. removeEventListener() document. removeEventListener() méthode supprime un gestionnaire d'événement qui a été attaché avec le document. addEventListener() méthode.

Remarque: Pour supprimer des gestionnaires d'événements, la fonction spécifiée avec la addEventListener() méthode doit être un externe, "named" fonction, comme dans l'exemple ci - dessus (myFunction) .

Les fonctions anonymes, comme "document. removeEventListener(" event ", function() {myScript});" ne fonctionnera pas.

Astuce: Utilisez l' élément. addEventListener() et élément. removeEventListener() méthodes pour ajouter / supprimer des gestionnaires d'événements à / à partir d' un élément spécifié.

Support du navigateur

Les chiffres du tableau indiquent la première version du navigateur qui prend en charge pleinement la méthode.

méthode
removeEventListener()	1.0	9.0	1.0	1.0	7.0

Note: Le removeEventListener() méthode est pas prise en charge dans Internet Explorer 8 et les versions antérieures et Opera 6.0 et les versions antérieures. Cependant, pour ces versions de navigateur spécifiques, vous pouvez utiliser la detachEvent() méthode pour supprimer des gestionnaires d'événements qui ont été attachés à la attachEvent() méthode (voir "More Examples" ci - dessous pour une solution multi-navigateur).

Syntaxe

document.removeEventListener( event , function , useCapture )

Les valeurs des paramètres

Paramètre	La description
event	Champs obligatoires. Une chaîne qui spécifie le nom de l'événement à supprimer. Note: Ne pas utiliser le "on" préfixe. Par exemple, utiliser "click" au lieu de "onclick" . Astuce: Pour une liste de tous les événements DOM HTML, consultez notre complet HTML DOM Référence objet d' événement .
function	Champs obligatoires. Indique la fonction à supprimer.
useCapture	Optionnel. Une valeur booléenne qui indique la phase d'événement pour supprimer le gestionnaire d'événements de. Valeurs possibles: true - Supprime le gestionnaire d'événements de la phase de capture Par défaut faux-. Supprime le gestionnaire d'événements à partir de la phase barbotage Remarque: Si le gestionnaire d'événements a été attaché deux fois, une avec la capture et un bouillonnement, chacun doit être retiré séparément.

Détails techniques

DOM Version:	DOM niveau 2 événements
Valeur de retour:	Aucune valeur de retour
changelog:	Le paramètre useCapture est devenu optionnel dans Firefox 6 et Opera 12.0 (has always been optional for Chrome, IE and Safari) en (has always been optional for Chrome, IE and Safari) Internet (has always been optional for Chrome, IE and Safari)

autres exemples

Exemple

Pour les navigateurs qui ne prennent pas en charge la removeEventListener() méthode, vous pouvez utiliser le detachEvent() méthode.

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);
}

Essayez vous - même »