EventTarget.addEventListener(type, listener, useCapture)

Description

Permet d'enregistrer un EventListener sur une cible d'évènement.

Version du DOM: DOM Level 2

Aucune donnée de disponible pour la compatibilité.

Paramètres

DOMString type: Le type d'évènement à enregistrer.
EventListener listener: Fonctions qui contient la méthode à utiliser lorsque l'évènement survient.
boolean useCapture: Initie ou non la capture d'évènement.

Retourne: rien

Si un EventListener est ajouté à une cible d'évènements lorsque cette cible traite actuellement un évènement, cette Event ne sera pas déclenché immédiatement mais lancé au prochain appel ou durant un autre stage du flux d'évènements, tel la phase de bulles.

Si plusieurs EventListeners identiques sont enregistrés sur le même EventTarget avec les mêmes paramètres, les doublons seront illiminés. Il n'appelerons donc pas l'EventListeners plusieurs fois.

Remarque sur l'attribut useCapture: If true, useCapture indicates that the user wishes to initiate capture. After initiating capture, all events of the specified type will be dispatched to the registered EventListener before being dispatched to any EventTargets beneath them in the tree. Events which are bubbling upward through the tree will not trigger an EventListener designated to use capture.

Exemple

Notes et commentaires des visiteurs

Ajouter une note

Yan Morin

2004-10-25 17:14:49

Pour envoyer des arguments (arg):
element.addEventListener("load", function() { foo(arg) }, true);

Pour envoyer un pointeur sur l'évènement:
element.addEventListener("load", function(e) { foo(e,arg) }, true);
Écrit par Jiri Znamenacek sur netscape.public.mozilla.dom

Ajouter une note