Méthode HTML DOM removeEventListener()
❮ L'objet élémentExemple
Supprimez un événement "mousemove" qui a été attaché avec la méthode addEventListener() :
// Attach an event handler to <div>
document.getElementById("myDIV").addEventListener("mousemove", myFunction);
// Remove the event handler from <div>
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);
Définition et utilisation
La méthode removeEventListener() supprime un gestionnaire d'événements qui a été attaché avec la méthode addEventListener() .
Remarque : Pour supprimer des gestionnaires d'événements, la fonction spécifiée avec la méthode addEventListener() doit être une fonction externe, comme dans l'exemple ci-dessus (myFunction).
Fonctions anonymes, comme " element .removeEventListener(" event ", function(){ myScript });" ne fonctionnera pas.
Prise en charge du navigateur
Les nombres dans le tableau indiquent la première version du navigateur qui prend entièrement en charge la méthode.
| Method | |||||
|---|---|---|---|---|---|
| removeEventListener() | 1.0 | 9.0 | 1.0 | 1.0 | 7.0 |
Syntaxe
element.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 :
var x = document.getElementById("myDIV");
if (x.removeEventListener) { // For all major browsers, except IE 8 and earlier
x.removeEventListener("mousemove", myFunction);
} else if (x.detachEvent) { // For IE 8 and earlier versions
x.detachEvent("onmousemove", myFunction);
}
Pages connexes
Tutoriel JavaScript : HTML DOM EventListener
Référence JavaScript : document.removeEventListener()
❮ L'objet élément