Méthode removeEventListener()du DOM HTML

元素对象参考手册Objet Element

Exemples

Supprimez l'événement "mousemove" ajouté par la méthode addEventListener() :

// Ajouter un gestionnaire d'événement à l'élément <div>
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

element.removeEventListener(event, function, useCapture)

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 :
  • true - Supprime le gestionnaire d'événements dans la phase de capture
  • false - Par défaut. Supprime le gestionnaire d'événements dans la phase de bouillonnement
Remarque :Si vous avez ajouté le gestionnaire d'événements deux fois, une fois dans la phase de capture et une fois dans la phase de bouillonnement, vous devez supprimer l'événement séparément.

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 :

var x = document.getElementById("myDIV");
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()


元素对象参考手册Objet Element

Autres extensions