DOM:element.removeEventListener
Un article de MDC.
Sommaire |
[modifier] Résumé
removeEventListener permet de retirer des gestionnaires d'évènements de la cible de l'évènement.
[modifier] Syntaxe
element.removeEventListener(type, listener, useCapture)
[modifier] Paramètres
type- Une chaîne représentant le type d'évènement enregistré.
listener- Une interface implémentée par l'utilisateur contenant les méthodes à appeler lorsque l'évènement se déclenche.
useCapture- S'il vaut
true,useCaptureindique que l'utilisateur désire initier la capture. Après initialisation de la capture, tous les évènements du type spécifié seront transmis à l'EventListenerenregistré avant d'être envoyés aux éventuelsEventTargetsqui suivent dans l'arbre. Les évènements qui se propagent vers le haut dans l'arbre (bouillonnement) ne déclencheront pas unEventListenerprévu pour utiliser la capture.
[modifier] 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.
[modifier] Voir également
[modifier] Spécification
- DOM Level 2 Events: removeEventListener (en) — traduction en français (non normative)