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".
AnimationEvent
AudioProcessingEvent
BeforeInputEvent
BeforeUnloadEvent
BlobEvent
ClipboardEvent
CloseEvent
CompositionEvent
CSSFontFaceLoadEvent
CustomEvent
DeviceLightEvent
DeviceMotionEvent
DeviceOrientationEvent
DeviceProximityEvent
DOMTransactionEvent
DragEvent
EditingBeforeInputEvent
ErrorEvent
FetchEvent
FocusEvent
GamepadEvent
HashChangeEvent
IDBVersionChangeEvent
InputEvent
KeyboardEvent
MediaStreamEvent
MessageEvent
MouseEvent
MutationEvent
OfflineAudioCompletionEvent
PageTransitionEvent
PointerEvent
PopStateEvent
ProgressEvent
RelatedEvent
RTCDataChannelEvent
RTCIdentityErrorEvent
RTCIdentityEvent
RTCPeerConnectionIceEvent
SensorEvent
StorageEvent
SVGEvent
SVGZoomEvent
TimeEvent
TouchEvent
TrackEvent
TransitionEvent
UIEvent
UserProximityEvent
WebGLContextEvent
WheelEvent
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- un booléen 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 surtrue,
avant qu'elle revienne d'un gestionnaire d'événements, empêche la propagation de l'événement. Event.cancelable
Lecture seule- Un booléen indiquant si l'évènement est annulable.
Event.composed
Lecture seule- Un booléen 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) deNode
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- indique 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()
etEvent.defaultPrevented
. Event.srcElement
- Un alias non standard (d'anciennes versions de MS IE) pour
Event.target
. Event.target
Lecture seule- une référence à la cible vers laquelle l'évènement était originellement destiné.
Event.timeStamp
Lecture seule- 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- 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)
Propriétés obsolètes
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éecomposed
.
Méthodes
Event.createEvent()
- Crée un nouvel
Event
(évènement) qui doit alors être initialisé par l'appel à la méthodeinitEvent()
. Event.composedPath()
- Renvoie le chemin de l'événement (objets sur lesquels les écouteurs seront appelés). Cela n'inclut pas les noeuds dans les arbres shadow si la racine shadow a été créée avec son
ShadowRoot.mode
fermé. Event.initEvent()
- initialise la valeur d'un évènement créé. Si l'évènement a déjà été propagé, la méthode ne produit rien.
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.
Méthodes obsolètes
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.getPreventDefault()
- Non standard. Retourne la valeur de
Event.defaultPrevented
. Utilisez à la placeEvent.defaultPrevented
.
Spécifications
Spécification Statut Commentaire DOM
La définition de 'Event' dans cette spécification. Standard évolutif
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- Types d'évènements disponibles : Référence Event
- Comparaison des cibles d'Event (target vs currentTarget vs relatedTarget vs originalTarget )
- Création et déclenchement d'évènements personnalisés
- Pour les développeurs de Firefox :