element.removeEventListener

Résumé

removeEventListener() permet de retirer des gestionnaires d'événements (objets EventListener) de la cible de l'événement.

Syntaxe

element.removeEventListener(type, listener, useCapture) 

Paramètres

type

Une chaîne représentant le type d'événement à retirer.

listener

Le paramètre listener indique l'EventListener à retirer.

useCapture

Indique si l'EventListener listener à retirer a été enregistré comme EventListener capturant, ou non. Si un EventListener a été enregistré deux fois, l'un en capture et l'autre pas, chacun doit être retiré séparément. Le retrait d'un EventListener capturant n'affecte pas une version non capturante du même EventListener, et vice versa.

Notes

Si un EventListener est retiré d'un EventTarget alors qu'il est en train de traiter un événement, il ne sera pas déclenché par les actions courantes. Les EventListeners ne peuvent jamais êtres invoqués après avoir été retirés. L'appel de removeEventListener avec des paramètres n'identifiant aucun EventListener actuellement enregistrés sur l'EventTarget n'a aucun effet.

Voir également

• addEventListener()

Spécification

• DOM Level 2 Events: removeEventListener (en) — traduction en français (non normative)