Objet Event XML DOM
- Page précédente Élément DOM
- Page suivante Collection HTML DOM
L'objet Event représente des informations sur l'événement.
Objet Event
Les propriétés de l'objet Event fournissent des détails sur l'événement (par exemple, l'élément sur lequel l'événement se produit). Les méthodes de l'objet Event peuvent contrôler la propagation de l'événement.
Le standard 2 des événements DOM définit un modèle d'événement standard, mis en œuvre par tous les navigateurs modernes excepté IE, qui définit son propre modèle non compatible. Cette page de référence liste les propriétés de l'objet Event standard et les propriétés de l'objet Event IE.
Attention :Dans le modèle d'événement standard, l'objet Event est transmis à la fonction gestionnaire d'événement ; mais dans le modèle d'événement IE, il est stocké dans la propriété event de l'objet Window.
Dans le modèle d'événement standard, divers sous-interfaces d'Event définissent des propriétés supplémentaires qui fournissent des détails liés à un type d'événement spécifique. Dans le modèle d'événement IE, il n'y a qu'un type d'objet Event, utilisé pour tous les types d'événements.
Propriétés Event standard
Les propriétés définies par le standard 2 du DOM événement sont listées ci-dessous.
Propriété | Description | IE | F | O | W3C |
---|---|---|---|---|---|
bubbles | Retourne une valeur booléenne, indiquant si l'événement est un type d'événement de bulle. | Non | 1 | 9 | Oui |
cancelable | Retourne une valeur booléenne, indiquant si l'événement peut annuler l'action par défaut. | Non | 1 | 9 | Oui |
currentTarget | Retourne l'élément qui a déclenché l'événement par son écouteur d'événement. | Non | 1 | 9 | Oui |
eventPhase | Retourne l'étape actuelle de la propagation de l'événement. | Oui | |||
target | Retourne l'élément (nœud cible de l'événement) qui a déclenché cet événement. | Non | 1 | 9 | Oui |
timeStamp | Retourne la date et l'heure à laquelle l'événement a été généré. | Non | 1 | 9 | Oui |
type | Retourne le nom de l'événement représenté par l'objet Event actuel. | 6 | 1 | 9 | Oui |
Méthodes Event standard
Les méthodes définies par le standard 2 du DOM événement sont listées ci-dessous. Le modèle d'événement IE ne prend pas en charge ces méthodes :
Méthode | Description | IE | F | O | W3C |
---|---|---|---|---|---|
initEvent() | Initialiser les propriétés de l'objet Event nouvellement créé. | Non | 1 | 9 | Oui |
preventDefault() | Informer le navigateur de ne pas exécuter l'action par défaut associée à l'événement. | Non | 1 | 9 | Oui |
stopPropagation() | Arrêter la propagation de l'événement à la capture, au traitement de l'élément cible ou à l'étape de bulle. Appel de cette méthode, le programmeur gérant l'événement sur ce nœud est appelé, et l'événement n'est plus délégué à d'autres nœuds. | Non | 1 | 9 | Oui |
Propriétés IE
IE ne prend pas en charge (au moins dans IE 7) le modèle d'événement DOM standard, et l'objet Event d'IE définit un ensemble de propriétés complètement différents.
Le modèle d'événement IE ne définit pas de hiérarchie d'héritage pour différents types d'événements, donc toutes les propriétés liées à tout type d'événement sont listées ici.
Propriété | Description |
---|---|
cancelBubble | Si l'handler d'événement veut empêcher la propagation de l'événement à l'objet englobant, il doit définir cette propriété à true. |
fromElement | Pour les événements mouseover et mouseout, fromElement fait référence à l'élément auquel le curseur de la souris s'est éloigné. |
keyCode |
Pour l'événement keypress, cette propriété déclare le code de caractère Unicode généré par la touche frappée. Pour les événements keydown et keyup, il spécifie le code de touche virtuelle de la touche frappée. Le code de touche virtuelle peut dépendre de la disposition du clavier utilisé. |
offsetX,offsetY | Coordonnées x et y de l'événement dans le système de coordonnées de l'élément source de l'événement. |
returnValue |
Si cette propriété est définie, sa valeur a une priorité supérieure à celle du retour de l'handled event. En mettant cette propriété à false, vous pouvez annuler l'action par défaut de l'élément source de l'événement. |
srcElement | Pour les objets Window, Document ou Element générant l'événement, c'est une référence à l'objet. |
toElement | Pour les événements mouseover et mouseout, cette propriété fait référence à l'élément auquel le curseur de la souris s'est déplacé. |
x,y | Coordonnées x et y de l'emplacement de l'événement, par rapport à l'élément englobant le plus intérieur positionné dynamiquement avec CSS. |
- Page précédente Élément DOM
- Page suivante Collection HTML DOM