L'interface Event représente tout événement qui a lieu dans le DOM ; certains sont générés par l'utilisateur (tels que des événements de souris ou de clavier), tandis que d'autres sont générés par des API (par exemple, des événements indiquant qu'une animation est terminée, qu'une vidéo a été suspendue, etc.). Il existe plusieurs types d'événements, dont certains utilisent d'autres interfaces basées sur l'interface principale Event. Event elle-même contient les propriétés et méthodes communes à tous les événements.

Interfaces basées sur Event

 Voici une liste d'interfaces basées sur l'interface principale Event , avec des liens vers leur documentation respective dans la référence de l'API MDN. Notez que toutes les interfaces d'événements ont des noms qui se terminent par "Event".

Constructeur

L'interface DOM <code>event</code> est exposée dans les objets <code>event</code> qui sont passés aux gestionnaires d'évènements sur divers éléments du DOM.

Event()
Crée un objet Event le retournant à l'appelant.

Propriétés

Event.bubbles Lecture seule
Renvoie une valeur booléenne indiquant si l'évènement se propage vers le haut dans le DOM ou non.
Event.cancelBubble
un alias historique de Event.stopPropagation (). Définir sa valeur sur true, avant qu'elle revienne d'un gestionnaire d'événements, empêche la propagation de l'événement.
Event.cancelable Lecture seule
Renvoie une valeur booléenne indiquant si l'évènement est annulable.
Event.composed Lecture seule
Valeur booléenne indiquant si l'événement peut ou non traverser la frontière entre le DOM shadow et le DOM normal.
Event.currentTarget Lecture seule
Une référence à la cible actuellement enregistrée pour l'événement. C'est l'objet auquel l'événement doit actuellement être envoyé ; il est possible que cela ait été modifié au cours du reciblage.
Event.deepPath 
Un Array (tableau) de Node  DOM à travers lesquels l'event a été propagé.
Event.defaultPrevented Lecture seule
indique si event.preventDefault() a été appelé ou non dans l'événement.
Event.eventPhase Lecture seule
Utilisée pour indiquer dans quelle phase de l'évènement on se trouve actuellement.
Event.explicitOriginalTarget Lecture seule
La cible explicite originale de l'évènement (spécifique à Mozilla).
Event.originalTarget Lecture seule
La cible originale de l'évènement, avant toute modification de celle-ci (spécifique à Mozilla).
Event.returnValue
une alternative non standard (de versions anciennes de MS IE) de Event.preventDefault() et Event.defaultPrevented.
Event.scoped Lecture seule
un Boolean indiquant si l'événement donné peut être propagé à travers la racine shadow dans le DOM standard. Cette propriété a été renommée composed.
Event.srcElement
Un alias non standard (d'anciennes versions de MS IE) pour Event.target.
Event.target Lecture seule
Renvoie une référence à la cible vers laquelle l'évènement était originellement destiné.
Event.timeStamp Lecture seule
Renvoie le moment de création de l'évènement, en millisecondes. Par spécification, cette valeur est le temps écoulé depuis le moment, mais en réalité les définitions des navigateurs varient ; en outre, le travail est en cours pour le changer en  DOMHighResTimeStamp
Event.type Lecture seule
Renvoie le nom de l'évènement (insensible à la casse).
Event.isTrusted Lecture seule
indique si l'évènement est initié par le navigateur ou non (après un click d'utilisateur ou par un script utilisant une méthode de création d'évènement comme event.initEvent)

Méthodes

Event.initEvent()
Initialise la valeur d'un objet Event créé. Si l'évènement a déjà été distribué, la méthode ne fait rien.
Event.preventBubble() Obsolète depuis Gecko 24
Empêche l'évènement de se propager. Obsolète, utilisez la méthode event.stopPropagation à la place.
Event.preventCapture() Obsolète depuis Gecko 24
Obsolète, utilisez la méthode event.stopPropagation à la place.
Event.preventDefault()
Annule l'évènement (s'il est annulable).
Event.stopImmediatePropagation()
Pour cet évènement particulier, aucun autre écouteur ne peut être appelé.  Ni ceux attachés au même élément, ni ceux attachés aux éléments qui seront traversés plus tard (en phase de capture, par exemple)
Event.stopPropagation()
Arrête la propagation ultérieure d'évènements dans le DOM.
Event.getPreventDefault()
Non standard. Retourne la valeur de Event.defaultPrevented. Utilisez à la place Event.defaultPrevented .

Spécifications

Spécification Statut Commentaire
DOM
La définition de 'Event' dans cette spécification.
Standard évolutif  

Compatibilité des navigateurs

Fonctionnalité Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Oui) (Oui) (Oui) (Oui) (Oui)
cancelBubble defined on Event ? 53 (53)[1] ? ? ?
Fonctionnalité Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Oui) (Oui) (Oui) (Oui) (Oui)
cancelBubble defined on Event ? 53.0 (53)[1] ? ? ?

[1] Avant Firefox 52, cette propriété était définie sur l'interface UIEvent. Voir bug 1298970 pour plus de détails.

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : loella16, hs0ucy, teoli, jsx, AshfaqHossain, Mgjbot, BenoitL, Fredchat, Takenbot
 Dernière mise à jour par : loella16,