event | NN 4 IE 4 DOM 2
L´objet event contient des informations sur un événement généré par l´utilisateur ou par le système. Mais il existe trois types différents d´objets event, un pour chaque modèle d´objet événement déployé dans les navigateurs: IE pour Windows, Navigator 4 et Netscape 6 (DOM W3C). IE 5 pour Macintosh implémente un mélange des versions IE pour Windows et Netscape 6. Reportez-vous au chapitre 6 pour des exemples de traitement d´événements dans un environnement compatible avec les différents navigateurs. Il est rare que la propriété d´un objet event s´applique à plus d´un des modèles d´événement, il faut donc faire particulièrement attention aux informations de compatibilité avec les navigateurs pour chacune des propriétés suivantes.
L´objet event Netscape 6, d´une certaine façon, est plus complexe du fait de sa nature axée sur les objets de la structure d´objet Event du DOM W3C sous-jacente. Au lieu d´être un objet comprenant tout (comme l´objet event de Microsoft Internet Explorer), l´objet event Netscape 6 présente différents ensembles de propriétés et méthodes reposant sur la classification de l´événement. Toutes les classes d´événements partagent les propriétés et méthodes de l´objet Event racine du DOM W3C. Mais les instances d´objets événements réelles appartiennent à l´une des sous-classes d´objets Event (et parfois, des sous-sous-classes). Ces sous-classes s´appellent UIEvent (événements d´interface utilisateur tels que DOMFocusIn), MouseEvent (notamment les événements de souris), MutationEvent (événements signalant une modification par script de la structure de noeuds du document) et, nouveauté dans le niveau 3 du DOM, TextEvent (événements ayant trait au clavier). Netscape 6 implémente sa propre classification temporaire des événements de clavier sous le nom KeyEvent, qui est une sous-classe de UIEvent, bien qu´elle emprunte des propriétés MouseEvent pour faciliter la création de scripts.
En général, cette division fonctionnelle des objets n´affectera pas le traitement des événements dans Netscape 6 car une fonction d´auditeur d´événements pour un type d´événement particulier recherchera les propriétés associées à cet événement. La classe d´événements n´a que peu d´importance. Toutefois, il est instructif de voir comment les propriétés et méthodes des objets événements se propagent en cascade dans cette structure axée sur les objets. Le tableau suivant illustre la distribution des propriétés dans les classes d´événements Netscape 6 et DOM W3C.
Le tableau suivant illustre la distribution des méthodes dans les classes d´événements Netscape et DOM W3C.
L´objet event dans Netscape 6 implémente aussi les propriétés de l´objet Event statique de Navigator 4 et hérite d´une liste impressionnante de constantes de l´objet TextEvent du DOM W3C représentant des codes de touches de clavier non alphanumériques (ayant des noms de constantes tels que eventObject.DOM_VK_PAGE_UP). Il a été annoncé que ces constantes de clavier feraient partie du module d´événements du DOM W3C niveau 3, mais sont déjà implémentées dans Netscape 6 (bien que les valeurs ne s´alignent pas exactement). Une liste de propriétés pour l´objet Event statique de Navigator 4 est présentée dans la section consacrée à l´objet Event suivant le présent exemple d´une instance d´événement.
Comme décrit en détails dans le chapitre 6, vous devez utiliser différentes techniques de scripts pour obtenir une référence à un objet event dans les modèles d´événements IE et Navigator. Une fois cette référence obtenue, vous êtes sur la bonne voie pour égaliser le traitement des événements sur les différents navigateurs. Les fragments d´exemple qui suivent supposent que les instructions de script précédentes ont obtenu une référence à l´objet event spécifique au navigateur (apparaît généralement dans cet exemple comme stocké dans une variable intitulée evt).
| Event | UIEvent | MouseEvent | KeyEventImplémenté dans Netscape 6 pour des fonctionnalités supplémentaires ou à la place du modèle d´événements de clavier de niveau 3 du DOM inachevé. Emprunte des propriétés MouseEvent pour faciliter la création de scripts. | TextEventProposé pour le niveau 3 du DOM, mais pas implémenté dans Netscape 6. | MutationEvent
--- | --- | --- | --- | --- | --- | ---
propriétés Event
bubbles | √ | √ | √ | √ | √ | √
cancelable | √ | √ | √ | √ | √ | √
cancelBubbleIE property implemented in Netscape 6 for cross-browser convenience. | √ | √ | √ | √ |  | √
currentTarget | √ | √ | √ | √ | √ | √
eventPhase | √ | √ | √ | √ | √ | √
originalTarget8 | √ | √ | √ | √ |  | √
target | √ | √ | √ | √ | √ | √
timeStamp | √ | √ | √ | √ | √ | √
type | √ | √ | √ | √ | √ | √
propriétés UIEvent
detail |  | √ | √ | √ | √ |
view |  | √ | √ | √ | √ |
propriétés MouseEvent
altKey |  |  | √ | √ |  |
button |  |  | √ |  |  |
clientX |  |  | √ | √ |  |
clientY |  |  | √ | √ |  |
ctrlKey |  |  | √ | √ |  |
metaKey |  |  | √ | √ |  |
relatedTarget |  |  | √ |  |  |
screenX |  |  | √ | √ |  |
screenY |  |  | √ | √ |  |
shiftKey |  |  | √ | √ |  |
propriétés KeyEvent
charCode8 |  |  |  | √ |  |
isChar8 |  |  |  | √ |  |
keyCode8 |  |  |  | √ |  |
rangeOffset8 |  |  |  | √ |  |
rangeParent8 |  |  |  | √ |  |
propriétés TextEvent |  |  |  |  |  |
keyVal9 |  |  |  |  | √ |
numPad9 |  |  |  |  | √ |
outputString9 |  |  |  |  | √ |
virtKeyVal9 |  |  |  |  | √ |
visibleOutputGenerated9 |  |  |  |  | √ |
propriétés MutationEvent
attrChange |  |  |  |  |  | √
attrName |  |  |  |  |  | √
newValue |  |  |  |  |  | √
prevValue |  |  |  |  |  | √
relatedNode |  |  |  |  |  | √
| Event | UIEvent | MouseEvent | KeyEventImplémenté dans Netscape 6 pour des fonctionnalités supplémentaires ou à la place du modèle d´événements de clavier du niveau 3 du DOM inachevé. Emprunte des propriétés MouseEvent pour faciliter la création de scripts. | TextEventProposé pour le niveau 3 du DOM, mais pas implémenté dans Netscape 6. | MutationEvent
--- | --- | --- | --- | --- | --- | ---
méthodes Event
initEvent( ) | √ | √ | √ | √ | √ | √
getPreventDefault( )11 | √ | √ | √ | √ |  | √
preventDefault( ) | √ | √ | √ | √ | √ | √
stopPropagation( ) | √ | √ | √ | √ | √ | √
Méthodes UIEvent
initUIEvent( ) |  | √ |  |  |  |
Méthodes MouseEvent
initMouseEvent( ) |  |  | √ |  |  |
Méthodes KeyEvent
initKeyEvent( ) |  |  |  | √ |  |
Méthodes TextEvent
checkModifier( )12 |  |  |  |  | √ |
initModifier( )12 |  |  |  |  | √ |
initTextEvent( )12 |  |  |  |  | √ |
Méthodes MutationEvent
initMutationEvent( ) |  |  |  |  |  | √
Référence de modèle d'objet
eventObj [window.]event
Propriétés spécifiques à l´objet
altKey | altLeft | attrChange | attrName
behaviorCookie | behaviorPart | bookmarks | boundElements
bubbles | button | cancelable | cancelBubble
charCode | clientX | clientY | contentOverflow
ctrlKey | ctrlLeft | currentTarget | data
dataFld | dataTransfer | detail | eventPhase
fromElement | isChar | keyCode | layerX
layerY | metaKey | modifiers | newValue
nextPage | offsetX | offsetY | originalTarget
pageX | pageY | prevValue | propertyName
qualifier | rangeOffset | rangeParent | reason
recordset | relatedNode | relatedTarget | repeat
returnValue | screenX | screenY | shiftKey
shiftLeft | srcElement | srcFilter | srcUrn
target | timeStamp | toElement | type
view | wheelDelta | which | x
y |  |  |
Méthodes spécifiques à l´objet
getPreventDefault( ) | initEvent( ) | initKeyEvent( ) | initMouseEvent( )
initMutationEvent( ) | initUIEvent( ) | preventDefault( ) | stopPropagation( )
Propriétés de gestionnaire d´événements spécifiques à l´objet
Aucune.

altKey | NN 6 IE 4 DOM 2
| Lecture seule
Renvoie true si la touche Alt gauche ou droite est enfoncée au moment du déclenchement de l´événement.
Exemple
    if (evt.altKey) {
        //handle case of Alt key down
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

altLeft | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
Renvoie true si la touche Alt à gauche est enfoncée au moment du déclenchement de l´événement.
Exemple
    if (evt.altLeft) {
        //handle case of left Alt key down
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

attrChange | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie, sous forme de nombre entier, un code correspondant au type de modification apportée à un noeud Attr à la suite d´un type d´événement DOMAttrModified d´un événement de mutation du DOM W3C. Chaque objet événement de mutation a trois constantes qui correspondent aussi aux valeurs de nombres entiers, que vous pouvez utiliser pour des comparaisons de scripts plus détaillées mais plus faciles à lire pour le traitement d´événements DOMAttrModified. Les valeurs et constantes sont indiquées dans le tableau suivant.
Valeur | Constante | Description
--- | --- | ---
1 | evtObj.MODIFICATION | Valeur modifiée du noeud Attr existant
2 | evtObj.ADDITION | Le noeud Attr a été ajouté à l´arborescence de documents
3 | evtObj.REMOVAL | Le noeud Attr a été supprimé de l´arborescence de documents
Exemple
    if (evt.attrChange == evt.MODIFICATION) {
        // do post-processing of attribute value change
    }
Valeur
Valeur, sous forme de nombre entier: 1 | 2 | 3.
Par défaut
Aucune.

attrName | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie une version sous forme de chaîne d´un noeud Attr affecté par un type d´événement DOMAttrModified d´un événement de mutation du DOM W3C.
Exemple
    var changedAttr = evt.attrName;
Valeur
Valeur de chaîne.
Par défaut
Une chaîne vide.

behaviorCookie, behaviorPart, bookmarks, boundElements | NN s.o. IE 6 (Win) DOM s.o.
| Lecture seule
Ces propriétés sont renvoyées par l´objet event dans IE 6 pour Windows (avec les valeurs 0, 0, null et le tableau vide, respectivement), mais Microsoft ne les documente pas. Elles seront peut-être prises et charge et implémentées dans une version future.

bubbles | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie la valeur booléenne true si le comportement par défaut de l´événement consiste à permettre à l´événement de se propager dans la hiérarchie d´événements.
Exemple
    if (evt.bubbles) {
        // handle case of the event bubbling
    }
Valeur
Valeur booléenne: true | false.
Par défaut
Spécifique au type d´événement.

button | NN 6 IE 4 DOM 2
| Lecture seule
Identifie quel bouton de la souris a été enfoncé pour déclencher l´événement de souris. N´oubliez pas qu´un Macintosh typique a une souris à un seul bouton. De plus, si vous voulez intercepter le menu contextuel du bouton droit de la souris dans IE pour Windows, utilisez le gestionnaire d´événements oncontextmenu.
Il existe une incohérence importante entre les spécifications et implémentations DOM par rapport aux nombres renvoyés pour cette propriété. Le DOM W3C, tel qu´il est implémenté dans Netscape 6, spécifie une valeur zéro pour indiquer le bouton gauche (principal). IE pour Windows prend en charge des valeurs supplémentaires pour les combinaisons de boutons de la souris.
Exemple
    if (evt.button == 2) {
        // handle event for right button
    }
Valeur
Valeur, sous forme de nombre entier, selon le tableau suivant.
Bouton(s) | IE | NN 6 | DOM W3C
Aucun bouton | 0 | null | null
Gauche (principal) | 1 | 0 | 0
Milieu | 4 | 1 | 1
Droit | 2 | 2 | 2
Gauche + droit | 3 | s.o | s.o
Gauche + milieu | 5 | s.o | s.o
Droit + milieu | 6 | s.o | s.o
Gauche + milieu + droit | 7 | s.o | s.o
Par défaut
0

cancelable | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie la valeur booléenne true si l´événement est du type dont le comportement par défaut sur l´élément cible peut être annulé avec la méthode preventDefault( ).
Exemple
    if (evt.cancelable ) {
        evt.preventDefault( );
    }
Valeur
Booléenne: true | false.
Par défaut
Spécifique au type d´événement.

cancelBubble | NN 6 IE 4 DOM s.o.
| Lecture/écriture
Spécifie si l'événement doit être propagé en remontant dans la hiérarchie du conteneur de l'élément. Pour remplacer le comportement par défaut et empêcher l'événement d'aller plus loin, paramétrez la valeur de cette propriété sur true. Netscape 6 implémente cette propriété IE pour des raisons de commodité. L´équivalent DOM W3C est la méthode stopPropagation( ) de l´objet event.
Exemple
    evt.cancelBubble = true;
Valeur
Booléenne: true | false.
Par défaut
false

charCode | NN 6 IE s.o. DOM s.o.
| Lecture seule
Renvoie un nombre entier correspondant à la valeur Unicode du caractère généré par la touche qui a déclenché l´événement. Le code de caractère est différent du code de touche, car le code de caractère fait la distinction entre les lettres majuscules et minuscules (par exemple 97 pour a et 65 pour A), alors que la valeur keyCode est toujours la même pour cette touche, quel que soit le caractère généré. Cette propriété ne contient généralement une valeur que pour les événements onkeypress; la valeur est de zéro pour les événements onkeydown et onkeyup. Pour l´équivalent IE, reportez-vous à la propriété keyCode.
Une fois le module d´événements de clavier du DOM W3C niveau 3 terminé, cette propriété portera probablement un nom différent.
Exemple
    if (evt.charCode > 96 && evt.charCode < 123) {
        evt.target.value += String.fromCharCode(evt.charCode - 32);
        evt.preventDefault( );
    }
Valeur
Nombre entier.
Par défaut
Spécifique à l´événement.

clientX, clientY | NN 6 IE 4 DOM 2
| Lecture seule
Indique les coordonnées horizontale (x) et verticale (y) de la souris lors du déclenchement de l'événement courant. Ces coordonnées correspondent à la zone de document visible de la fenêtre ou du cadre du navigateur. Pour convertir ces coordonnées à celles du document dans IE, n´oubliez pas d´ajouter les valeurs de défilement de l´élément body (ou les valeurs de défilement de l´élément html en mode IE 6 compatible avec les normes). Pour Netscape 6, les propriétés pageX et pageY fournissent des coordonnées dans l´espace du document.
Exemple
    if ((evt.clientX >= 10 && evt.clientX <= 20) &&
    (evt.clientY >= 50 && evt.clientY <= 100)) {
        // process code for click in hot zone bounded by 10,50 and 20,100
    }
Valeur
Nombre entier de pixels.
Par défaut
Aucune.

contentOverflow | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
Renvoie la valeur booléenne true si le contenu qui n´est pas encore affiché requiert un nouveau rectangle de mise en page pour le contenu de débordement. La propriété ne s´applique qu´à l´événement onlayoutcomplete si vous déployez des modèles d´impression ou d´aperçu avant impression personnalisés. Pour en savoir plus sur la programmation C++ nécessaire à de tels modèles, visitez http://msdn.microsoft.com/library/default.asp?url=/workshop/browser/hosting/printpreview/reference/reference.asp.
Valeur
Booléenne: true | false.
Par défaut
false

ctrlKey | NN 6 IE 4 DOM 2
| Lecture seule
Renvoie true si la touche Ctrl à gauche ou à droite est enfoncée au moment du déclenchement de l´événement. Reportez-vous au chapitre 6 pour tester cette touche dans un code de gestion d'événements compatible avec les différents navigateurs.
Exemple
    if (evt.ctrlKey) {
        // process for Control key being down
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

ctrlLeft | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
Renvoie true si la touche Ctrl de gauche est enfoncée au moment du déclenchement de l´événement.
Exemple
    if (evt.ctrlLeft) {
        // process for left Control key being down
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

currentTarget | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie une référence au noeud dont l´auditeur d´événements est en train de traiter l´événement. Permet à une fonction de savoir si elle est invoquée à partir du noeud cible lui-même ou à partir d´une autre noeud pendant la propagation d´un événement.
Exemple
    if (evt.currentTarget.nodeType == 1) {
        // process at element level for possible text node target
    }
Valeur
Référence à un noeud dans la hiérarchie de propagation des événements.
Par défaut
Référence à la cible de l´événement.

data | NN |4| IE s.o. DOM n/a
| Lecture seule
Fournit des données accessoires associées à l'événement dragdrop spécifique à Navigator 4. La propriété data renvoie l´URL de l´élément déposé dans la fenêtre ou le cadre.
Exemple
    var srcDoc = evtObj.data;
Valeur
Chaîne.
Par défaut
Aucune.

dataFld | NN s.o. IE 5 (Win) DOM s.o.
| Lecture/écriture
Utilisée avec la liaison de données IE, la propriété dataFld contient le nom du champ de l´objet de source de données qui est associé à la colonne du tableau HTML. Cette propriété reçoit une valeur après un événement oncellchange dans un tableau généré avec la liaison d´événements.
Valeur
Chaîne.
Par défaut
Une chaîne vide.

dataTransfer | NN s.o. IE 5 (Win) DOM s.o.
| Lecture seule
Renvoie une référence à l´objet dataTransfer pour faciliter le déplacement des données personnalisées entre les éléments sources et les éléments de destination au cours d´une opération « glisser-déposer ». Reportez-vous à l'objet dataTransfer pour plus de détails au sujet de son utilisation.
Valeur
Référence à un objet dataTransfer.
Par défaut
Aucune.

detail | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie un nombre entier contenant des informations supplémentaires spécifiques au type d´événement. Pour les événements de boutons de souris, le nombre indique combien de fois l´utilisateur a cliqué avec la souris au même emplacement de coordonnées que le clic précédent sans en éloigner le curseur. Si le curseur est déplacé, le compteur est remis à zéro en préparation du prochain clic du bouton de la souris. Pour un type d´événement DOMActivate, la propriété detail renvoie 1 pour l´activation par une simple action de l´utilisateur (clic ou tabulation) et 2 pour une action plus complexe (double-clic).
Exemple
    if (evt.type == "click" && evt.detail > 5) {
        alert("Relax, dude!");
    }
Valeur
Nombre entier.
Par défaut
Spécifique au type d´événement.

eventPhase | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie un nombre entier qui indique si l´auditeur d´événements traite l´événement pendant la phase de capture, une fois à la cible de l´événement ou pendant la phase de remontée. Les objets événements du DOM W3C implémentent aussi des constantes en anglais correspondant aux trois valeurs.
Exemple
    if (evt.eventPhase == evt.AT_TARGET) {
        // process event listener from the event target
    }
Valeur
Valeur, sous forme de nombre entier, du tableau suivant.
Valeur | Constante
1 | eventObjectReference.CAPTURING_PHASE
2 | eventObjectReference.AT_TARGET
3 | eventObjectReference.BUBBLING_PHASE
Par défaut
2

fromElement | NN s.o. IE 4 DOM s.o.
| Lecture seule
Renvoie une référence à l'objet, là où le curseur se trouvait juste avant l'événement onMouseOver ou onMouseOut.
Exemple
    if (evt.fromElement.id == "lowerLevel") {
        ...
    }
Valeur
Référence de l'objet élément.
Par défaut
Aucune.

isChar | NN 6 IE s.o. DOM s.o.
| Lecture seule
Renvoie true si l´événement clavier provient d´une touche de caractère. En fait, Netscape 6 renvoie true pour toutes les touches, y compris les touches de fonction. Utilisez les gestionnaires d´événements onkeydown ou onkeyup pour traiter les touches autres que les touches de caractères.
Valeur
Valeur booléenne: true | false.
Par défaut
true

keyCode | NN 6 IE 4 DOM s.o.
| Lecture/écriture
Caractéristiques un peu différentes pour IE et Netscape 6, mais les deux classes de navigateur traitent la propriété keyCode de la même façon pour les événements onkeydown et onkeyup. Pour ces événements, la propriété keyCode renvoie le code associé à la touche du clavier, quel que soit le caractère généré par cette touche. Sur un clavier basé sur l´alphabet latin typique, la touche A génère le code 65. Les touches de modification génèrent leurs propres événements et codes lorsque l´utilisateur appuie dessus et les rel che.
Pour l´événement onKeyPress, seul IE renvoie une valeur significative, correspondant à la valeur Unicode du caractère réel affiché dans une zone de texte en tapant le caractère (par exemple 65 pour A et 97 pour a). Dans Netscape 6, la propriété équivalente pour l´événement onkeypress est charCode. Reportez-vous au chapitre 6 pour le traitement des événements clavier.
Exemple
    if (evt.keyCode == 65) {
        ...
    }
Valeur
Nombre entier.
Par défaut
Aucune.

layerX, layerY | NN 4 IE s.o. DOM s.o.
| Lecture seule
Indique les coordonnées horizontale (x) et verticale (y) de la souris lors du déclenchement de l'événement courant. Ces coordonnées sont relatives par rapport au calque conteneur. Si aucun calque ou élément positionnable n'a été défini, le calque par défaut du document de base est utilisé comme point de référence; il équivaut donc aux propriétés pageX et pageY. Dans Netscape 6 et versions ultérieures, ces propriétés sont mesurées par rapport à l´espace rectangulaire de l´élément pour les éléments input de texte et de mot de passe, les éléments textarea et les éléments select.
Exemple
    if ((evt.layerX >= 10 && evt.layerX <= 20) &&
    (evt.layerY >= 50 && evt.layerY <= 100)) {
        // process code for click in hot zone bounded by 10,50 and 20,100
    }
Valeur
Nombre entier de pixels.
Par défaut
Aucune

metaKey | NN 6 IE s.o. DOM s.o.
| Lecture seule
Renvoie true si la touche Meta du clavier (touche Command sur le clavier Macintosh) a été enfoncée au moment du déclenchement de l´événement.
Exemple
    if (evt.metaKey) {
        // process for meta key being down
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

modifiers | NN |4| IE s.o. DOM n/a
| Lecture seule
Fournit un nombre entier indiquant la ou les touches de modification du clavier maintenues enfoncées lors du déclenchement de l'événement unique à Navigator 4. Vous pouvez utiliser l´opérateur & associé à un ensemble de constantes de l'objet Event statiques pour savoir si une touche de modification particulière a été enfoncée. Reportez-vous au chapitre 6.
Exemple
    var altKeyPressed = evt.modifiers & Event.ALT_MASK;
Valeur
Nombre entier.
Par défaut
0

newValue, prevValue | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie une chaîne avec les valeurs nouvelle et précédente (respectivement) de données associées à des types d´événement DOMAttrModified et DOMCharacterDataModified d´une classe d´événements de mutation du DOM W3C. Ces informations peuvent être utiles pour créer un tampon d´annulation pour les modifications de l´attribut d´un élément ou le contenu d´un noeud CharacterData.
Exemple
    undoAttrBuffer = {attrNode:evt.relatedNode, oldVal:evt.prevValue};
Valeur
Valeur de chaîne.
Par défaut
Une chaîne vide.

nextPage | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
Renvoie une chaîne indiquant si la page suivante d´un modèle d´impression personnalisé apparaîtra sur une page tournée vers la gauche ou la droite. Pour en savoir plus sur la programmation C++ nécessaire pour les modèles, visitez http://msdn.microsoft.com/library/default.asp?url=/workshop/browser/hosting/printpreview/reference/reference.asp.
Valeur
Constante sous forme de chaîne: left | right | (chaîne vide).
Par défaut
Une chaîne vide.

offsetX, offsetY | NN s.o. IE 4 DOM s.o.
| Lecture seule
Fournit les coordonnées gauche et supérieure du pointeur de la souris par rapport à l'élément conteneur (à l'exception du remplissage, des bordures ou des marges) lors du déclenchement de l'événement. Vous pouvez déterminer l'élément conteneur gr ce à la propriété offsetParent. Reportez-vous à la section 9.2 au début de ce chapitre pour en savoir plus sur les anomalies des mesures de décalage dans Internet Explorer.
Exemple
    if (evt.offsetX <= 20 && evt.offsetY <=40) {
        ...
    }
Valeur
Nombre entier de pixels.
Par défaut
Aucune.

originalTarget | NN 6 IE s.o. DOM s.o.
| Lecture seule
Renvoie une référence à un noeud que Netscape 6 traite au niveau interne comme la vraie première cible de l´événement. En règle générale, ces informations ne sont pas utiles pour la création de scripts DHTML, car elles plongent dans la construction interne de certains éléments (par exemple un élément div est imbriqué dans un élément input de type texte, mais l´arborescence de noeuds du DOM ne considère pas l´élément div comme un noeud enfant de l´élément input). Pour de nombreux événements et cibles d´événements, les propriétés target et originalTarget référencent le même noeud.
Valeur
Référence de l´objet noeud.
Par défaut
Spécifique à l´élément.

pageX, pageY | NN 4 IE s.o. DOM s.o.
| Lecture seule
Fournit les coordonnées gauche et supérieure du contenu de l'élément par rapport au coin supérieur gauche de la page lors du déclenchement de l'événement. Les mesures ignorent le défilement de la page.
Exemple
    if (evt.pageX <= 20 && evt.pageY <=40) {
        ...
    }
Valeur
Nombre entier de pixels.
Par défaut
Aucune.

prevValue |
Voir newValue.

propertyName | NN s.o. IE 5 (Win) DOM s.o.
| Lecture/écriture
Renvoie une chaîne contenant le nom de la propriété de l´objet qui a changé pendant l´événement onpropertychange. Pour les autres types d´événement, la valeur est une chaîne vide. Si la propriété modifiée est une propriété d´une propriété (par exemple une propriété de la propriété style d´un élément), la valeur renvoyée affiche la version avec un point, comme style.color.
Exemple
    if (evt.propertyName.indexOf("style") == 0) {
        // perform further processing on a changed style
    }
Valeur
Nom de propriété sous forme de chaîne.
Par défaut
Une chaîne vide.

qualifier | NN s.o. IE 5 (Win) DOM s.o.
| Lecture/écriture
Pour l´utilisation avec les événements de liaison de données IE (tels que ondatasetcomplete). Renvoie une valeur de chaîne indiquant un élément de source de données, qui peut alors être utilisé comme paramètre pour accéder à une source de données intitulée recordset. Consultez la documentation Microsoft pour l´objet de source de données à utiliser et voir s´il fournit des données de qualificateur.
Valeur
Chaîne.
Par défaut
Une chaîne vide.

rangeOffset | NN 6 IE s.o. DOM s.o.
| Lecture seule
Renvoie un nombre entier du décalage du caractère dans un noeud que le DOM Netscape 6 considère comme un point de fin de plage potentiel. La référence au noeud se trouve dans la propriété associée rangeParent de l´objet event. Ces deux valeurs peuvent être transmises en tant que paramètre aux méthodes d´objet Range du DOM W3C pour définir un point de début ou de fin. Ainsi, un auditeur d´événements mousedown pourrait établir le point de début d´une plage pendant qu´une fonction d´auditeur d´événements mouseup pourrait définit le point de fin (ces deux fonctions fournissant des valeurs rangeParent et rangeOffset aux méthodes de l´objet Range).
Exemple
    var rng;
    function processMouseDown(evt) {
        rng = document.createRange( );
        rng.setStart(evt.rangeParent, evt.rangeOffset);
    }
Valeur
Nombre entier.
Par défaut
0

rangeParent | NN 6 IE s.o. DOM s.o.
| Lecture seule
Renvoie une référence au noeud de l´arborescence de documents qui conviendrait comme point de début ou de fin pour une plage de texte W3C. A utiliser avec la propriété rangeOffset.
Exemple
    function processMouseUp(evt) {
        rng.setEnd(evt.rangeParent, evt.rangeOffset);
    }
Valeur
Référence à un noeud.
Par défaut
Aucune.

">
reason NN s.o. IE 4 DOM s.o.

Lecture/écriture

Renvoie un code associé à un événement ondatasetcomplete indiquant si le transfert de données de liaison IE a réussi. Si le transfert est incomplet, le code spécifie s'il a été interrompu suite à une erreur ou à un arrêt volontaire du client ou de l'utilisateur. Pour l'événement ondatasetcomplete, examinez cette propriété dans un gestionnaire d'événements. Cette propriété est en lecture seule dans Internet Explorer 4. IE 5 pour Mac inclut cette propriété de l´objet event, mais n´implémente pas l´événement associé.

Exemple

    if (evt.reason == 2) {
        alert("An error occurred during the most recent update.");
    }

Valeur

Une des trois valeurs possibles (nombre entier):

- Le transfert a réussi
- Le transfert s'est arrêté
- Une erreur a interrompu le transfert

0

Le transfert a réussi

1

Le transfert s'est arrêté

2

Une erreur a interrompu le transfert

Par défaut

Aucune.

recordset | NN s.o. IE 5 (Win) DOM s.o.
| Lecture/écriture
Renvoie une référence à un objet recordset de liaison de données IE associé à un événement ayant trait aux données.
Valeur
Référence d´objet
Par défaut
Aucune.

relatedNode | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie une référence à un noeud affecté par l´action qui déclenche des événements de mutation du DOM W3C. Cela fournit un chemin plus direct vers un noeud affecté par l´événement, selon le tableau suivant.
Pour les autres types d´événements de mutation, la propriété renvoie null; pour les autres classes d´événements, la propriété renvoie undefined.
Type d´événement de mutation | Référence eventObj.relatedNode
--- | ---
DOMNodeInserted | Noeud parent du noeud inséré
DOMNodeRemoved | Noeud parent original du noeud supprimé
DOMAttrModified | noeud Attr
Exemple
    var newParent = evt.relatedNode;
Valeur
Référence à un noeud, null ou undefined.
Par défaut
Aucune.

relatedTarget | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie une référence à un noeud affiché dans l´arborescence de documents qui était la cible précédente ou suivante pour les événements, suivant le type d´événement. Pour un type d´événement mouseover, la propriété relatedTarget fait référence au noeud à partir duquel le curseur est arrivé; pour un événement mouseout, la propriété relatedTarget fait référence au noeud à partir duquel le curseur est parti. La fonctionnalité IE se trouve dans les propriétés fromElement et toElement de l´objet event IE.
Exemple
    var beenThere = evt.relatedTarget;
Valeur
Référence à un noeud.
Par défaut
Aucune.

repeat | NN s.o. IE 5 (Win) DOM s.o.
| Lecture/écriture
Pour un événement onkeydown uniquement, la valeur booléenne true n´est renvoyée que si la touche a été enfoncée assez longtemps pour initier le mode de répétition automatique. Vous pouvez empêcher l´entrée des touches répétées automatiquement dans un champ avec l´exemple suivant.
Exemple
    function handleKeyDown( ) {
        if (evt.repeat) {
            evt.returnValue = false;
        }
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

returnValue | NN s.o. IE 4 DOM s.o.
| Lecture/écriture
Fournit la valeur à retourner à l'élément source de l'événement pour autoriser ou interdire l'action par défaut de l'élément connectée à l'événement. Si la valeur de event.returnValue est false, l'élément n'exécute pas d'opération ordinaire, telle que la navigation vers un lien ou l'envoi du formulaire. Cette propriété n´influence pas la valeur réelle que vous souhaitez peut-être renvoyer à partir d´une fonction de gestionnaire d´événements.
Exemple
    evt.returnValue = false;
Valeur
Valeur booléenne: true | false.
Par défaut
true

screenX, screenY | NN 4 IE 4 DOM 2
| Lecture seule
Fournit les points de coordonnées horizontale et verticale (exprimées en pixels) et correspondant à la position du curseur à l'écran lors du déclenchement de l'événement. Le point 0,0 représente le coin supérieur gauche de l'écran. Aucune coordination particulière n'existe avec la fenêtre du navigateur ou le document, sauf si vous avez positionné la fenêtre et connaissez l'emplacement de la zone de la fenêtre active par rapport à l'écran.
Exemple
    if (evt.screenX < 5 || evt.screenY < 5) {
        alert("You\'re too close to the edge!");
    }
Valeur
Tout entier positif, ou zéro.
Par défaut
0

shiftKey | NN 6 IE 4 DOM 2
| Lecture seule
Renvoie true si la touche Maj gauche ou droite est enfoncée au moment du déclenchement de l´événement.
Exemple
    if (evt.shiftKey) {
        // process for Shift key being down
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

shiftLeft | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
Renvoie true si la touche Maj gauche est enfoncée au moment du déclenchement de l´événement.
Exemple
    if (evt.shiftLeft) {
        // process for left Shift key being down
    }
Valeur
Valeur booléenne: true | false.
Par défaut
false

srcElement | NN s.o. IE 4 DOM s.o.
| Lecture seule
Référence à l'objet élément ayant initialement reçu l'événement courant. Cette propriété est très commode dans des structures de type switch pour une fonction de gestion d'événements traitant le même type d'événement pour le compte de plusieurs éléments. Pour Netscape 6, utilisez la propriété target.
Exemple
    switch (evt.srcElement.id) {
        case "myDIV":
            ...
        ...
    }
Valeur
Référence de l'objet élément.
Par défaut
Aucune.

srcFilter | NN s.o. IE 4 (Win) DOM s.o.
| Lecture seule
Référence à l'objet filtre qui a déclenché un événement onfilterchange.
Valeur
Référence de l'objet filtre.
Par défaut
Aucune.

srcUrn | NN s.o. IE 5 (Win) DOM s.o.
| Lecture seule
Chaîne de l´URN d´un comportement associé qui a déclenché un événement.
Valeur
Chaîne.
Par défaut
null

target | NN 4 IE s.o DOM 2
| Lecture seule
Référence à l'objet noeud qui est la destination voulue de l'événement courant. Contrairement à la propriété srcElement IE correspondante, la propriété target dans Netscape 6 peut faire référence à un noeud de texte, même si le gestionnaire d´événements est défini pour l´élément qui entoure le noeud de texte. Le traitement des événements pour un tel scénario doit prendre nodeType en compte afin d´égaliser la référence à l´élément environnant dans IE et Navigator. Reportez-vous au chapitre 6 pour des exemples de code de gestion d'événements compatible avec les différents navigateurs.
Exemple
    var elem = (evt.target) ? evt.target: evt.srcElement;
Valeur
Référence de l´objet noeud.
Par défaut
Aucune.

timeStamp | NN 6 IE s.o DOM 2
| Lecture seule
Fournit un nombre entier indiquant une valeur en millisecondes que vous pouvez utiliser comme indicateur relatif du moment où un événement s´est produit. Bien que le DOM W3C suggère que la valeur devrait être le temps écoulé depuis le 1er janvier 1970 (l´époque Java et JavaScript), vous ne pouvez pas vous fier à cette valeur. Mais vous pouvez comparer la valeur de la propriété timeStamp pour deux événements afin d´en dériver le temps écoulé entre ces événements.
Exemple
    var clickTime = evt.timeStamp;
Valeur
Nombre entier.
Par défaut
Horodateur actuel.

toElement | NN s.o. IE 4 DOM s.o.
| Lecture seule
Renvoie une référence à l'objet élément vers lequel s'est déplacé le curseur qui a déclenché l'événement onmouseout.
Exemple
    if (evt.toElement.id == "upperLevel") {
        ...
    }
Valeur
Référence de l'objet élément.
Par défaut
Aucune.

type | NN 4 IE 4 DOM 2
| Lecture seule
Indique le type de l'événement courant (sans le préfixe "on"). Les valeurs sont toutes en lettres minuscules.
Exemple
    if (evt.type == "change") {
        ...
    }
Valeur
Tout nom d'événement (sans le préfixe “ on ”) sous forme de chaîne.
Par défaut
Aucune.

view | NN 6 IE s.o DOM 2
| Lecture seule
Renvoie une référence à l´affichage du DOM W3C (c´est-à-dire l´objet window ou frame dans l´implémentation Netscape) dans lequel l´événement s´est produit.
Exemple
    var whichWin = evt.view;
Valeur
Référence à un objet de type window.
Par défaut
Fenêtre active.

wheelDelta | NN s.o. IE 5,5 (Win) DOM s.o.
| Lecture seule
Renvoie un nombre entier indiquant dans quelle direction l´utilisateur a fait rouler la roue de la souris (pour une souris dotée d´une roue) pendant un événement onmousewheel. Une valeur positive signifie que l´utilisateur a fait rouler la roue vers l´écran et une valeur négative qu´il l´a fait rouler dans la direction opposée.
Exemple
    if (evt.wheelDelta > 0) {
        ...
    }
Valeur
Nombre entier, généralement 120 ou -120.
Par défaut
Aucune.

which | NN 4 IE s.o. DOM s.o.
| Lecture seule
Renvoie une valeur appropriée au type d'événement. Pour les événements de la souris, la valeur de la propriété est un nombre entier indiquant le bouton de souris utilisé (1 pour le bouton gauche; 3 pour le bouton droit). Pour les événements du clavier, la valeur de propriété est un nombre entier corrrespondant au code ASCII du caractère du clavier. Cette propriété demeure dans Netscape 6 en tant que reste du modèle d´événements Navigator 4. Utilisez les propriétés button, charCode et keyCode si vous n´avez plus besoin de prendre Navigator 4 en charge.
Exemple
    if (evt.which == 65) {
        ...
    }
Valeur
Nombre entier.
Par défaut
Aucune.

x, y | NN s.o. IE 4 DOM s.o.
| Lecture seule
Renvoie les coordonnées horizontale et verticale, en pixels, du pointeur de la souris lors du déclenchement de l'événement courant. Pour tous les éléments à positionnement relatif, le système de coordonnées est l´élément body (ou l´élément html en mode IE 6 compatible avec les normes). Si l´événement se produit dans le rectangle d´un élément à positionnement relatif, le système de coordonnées est limité à l´espace de cet élément (le coin supérieur gauche de l´élément étant 0,0). La valeur -1 est renvoyée si le pointeur se trouvait hors de la zone document de la fenêtre du navigateur.
Exemple
    if (evt.x < 20 && evt.y < 30) {
        ...
    }
Valeur
Nombre entier.
Par défaut
Aucune.

getPreventDefault( ) | NN 6 IE s.o. DOM s.o.
Renvoie la valeur booléenne true si la méthode preventDefault( ) a été appelée pour l´objet élément courant. En gros, permet à un script de se renseigner au sujet de l´état visant à empêcher les actions par défaut. Cette propriété est une extension Netscape 6 du module d´événements du DOM W3C.
Paramètres
Aucune.
Valeur renvoyée
Valeur booléenne: true | false.

initEvent( ) | NN 6 IE s.o DOM 2
initEvent("eventType", bubblesFlag, cancelableFlag) |
Indique l´initialisation minimum requise sur un objet événement généré par document.createEvent( ). Après l´initialisation d´un événement généré par script, il peut être utilisé comme paramètre de la méthode dispatchEvent( ) d´un noeud.
Paramètres
Identificateur, sous forme de chaîne, d´un type d´événement, tel que click, mousedown, keypress, DOMAttrModified, etc. Valeur booléenne (true | false) déterminant si le comportement de propagation par défaut d´un événement est la remontée. Valeur booléenne (true | false) déterminant si l´action par défaut d´un événement peut être empêchée avec la méthode preventDefault( ).
Valeur renvoyée
Aucune.

initKeyEvent( ) | NN 6 IE s.o. DOM s.o.
initKeyEvent("eventType", bubblesFlag, cancelableFlag, view, ctrlKeyFlag, altKeyFlag, shiftKeyFlag, metaKeyFlag, keyCode, charCode) |
Initialise un objet événement nouvellement créé avec un ensemble complet de valeurs de propriétés associées à tout événement clavier. Le nom et la composition des paramètres de cette méthode risquent de changer pour le module d´événements du DOM niveau 3 officiel, dans lequel les événements clavier (nom proposé: événements texte) seront publiés. Tous les paramètres doivent être présents et configurés sur les valeurs par défaut (telles que false pour les drapeaux de touches booléens ou zéro pour les numéros de codes de nombres entiers) si les valeurs n´ont pas de signification pour le type d´événement.
Paramètres
Identificateur, sous forme de chaîne, pour le type d´événement: keydown, keypress, keyup. Valeur booléenne (true | false) déterminant si le comportement de propagation par défaut d´un événement est la remontée. Valeur booléenne (true | false) déterminant si l´action par défaut d´un événement peut être empêchée avec la méthode preventDefault( ). Référence à un objet fenêtre ou cadre dans lequel l´événement généré dynamiquement est censé s´être produit. Valeur booléenne (true | false) de l´état de la touche Ctrl pour cet événement. Valeur booléenne (true | false) de l´état de la touche Alt pour cet événement. Valeur booléenne (true | false) de l´état de la touche Maj pour cet événement. Valeur booléenne (true | false) de l´état de la touche Meta (touche Commande pour Macintosh) pour cet événement. Code de touche, sous forme de nombre entier, pour cet événement. Code de caractère, sous forme de nombre entier, pour cet événement.
Valeur renvoyée
Aucune.

initMouseEvent( ) | NN 6 IE s.o DOM 2
initMouseEvent("eventType", bubblesFlag, cancelableFlag, view, detailVal, screenX, screenY, clientX, clientY, ctrlKeyFlag, altKeyFlag, shiftKeyFlag, metaKeyFlag, buttonCode, relatedTargetNodeRef) |
Initialise un objet événement nouvellement créé avec un ensemble complet de valeurs de propriétés associées à tout événement de souris. Tous les paramètres doivent être présents et configurés sur les valeurs par défaut (telles que false pour les drapeaux de touches booléens, zéro pour les numéros de codes de nombres entiers ou null pour une référence de noeud) si les valeurs n´ont pas de signification pour le type d´événement.
Paramètres
Identificateur, sous forme de chaîne, d´un type d´événement, tel que click, mousedown, mousemove, mouseout, mouseover, mouseup. Valeur booléenne (true | false) déterminant si le comportement de propagation par défaut d´un événement est la remontée. Valeur booléenne (true | false) déterminant si l´action par défaut d´un événement peut être empêchée avec la méthode preventDefault( ). Référence à un objet fenêtre ou cadre dans lequel l´événement généré dynamiquement est censé s´être produit. Code, sous forme de nombre entier, des données détaillées associées à l'événement. Nombre entier pour la coordonnée d´écran horizontale. Nombre entier pour la coordonnée d´écran verticale. Nombre entier pour la coordonnée de fenêtre de navigateur horizontale. Nombre entier pour la coordonnée de fenêtre de navigateur verticale. Valeur booléenne (true | false) de l´état de la touche Ctrl pour cet événement. Valeur booléenne (true | false) de l´état de la touche Alt pour cet événement. Valeur booléenne (true | false) de l´état de la touche Maj pour cet événement. Valeur booléenne (true | false) de l´état de la touche Meta (touche Commande pour Macintosh) pour cet événement. Code de bouton, sous forme de nombre entier, pour cet événement. Référence au noeud recevant l´événement de souris précédent ou suivant.
Valeur renvoyée
Aucune.

initMutationEvent( ) | NN 6 IE s.o DOM 2
initMutationEvent("eventType", bubblesFlag, cancelableFlag, relatedNodeRef, prevValue, newValue, attrName, attrChangeCode) |
Initialise un objet événement nouvellement créé avec un ensemble complet de valeurs de propriétés associées à tout événement de mutation. Tous les paramètres doivent être présents et configurés sur les valeurs par défaut (telles que false pour les drapeaux de touches booléens ou zéro pour les numéros de codes de nombres entiers) si les valeurs n´ont pas de signification pour le type d´événement.
Paramètres
Identificateur, sous forme de chaîne, pour le type d´événement: DOMAttrModified, DOMCharacterDataModified, DOMNodeInserted, DOMNodeInsertedIntoDocument, DOMNodeRemoved, DOMNodeRemovedFrom-Document, DOMSubtreeModified. Valeur booléenne (true | false) déterminant si le comportement de propagation par défaut d´un événement est la remontée. Valeur booléenne (true | false) déterminant si l´action par défaut d´un événement peut être empêchée avec la méthode preventDefault( ). Référence à un noeud associé à l´événement. Applicable uniquement aux types d´événements DOMNodeInserted, DOMNodeRemoved, DOMAttrModified. Chaîne de la valeur précédente pour un noeud Attr ou CharacterData. Applicable uniquement aux types d´événements DOMAttrModified et DOMCharacterDataModified. Chaîne de la nouvelle valeur pour un noeud Attr ou CharacterData. Applicable uniquement aux types d´événements DOMAttrModified et DOMCharacterDataModified. Chaîne du nom d´un noeud Attr. Applicable uniquement au type d´événement DOMAttrModified. Nombre entier pour le code correspondant au type de modification que l´événement simule. Applicable uniquement au type d´événement DOMAttrModified.
Valeur renvoyée
Aucune.

initUIEvent( ) | NN 6 IE s.o DOM 2
initUIEvent("eventType", bubblesFlag, cancelableFlag, view, detailVal) |
Initialise un objet événement nouvellement créé avec un ensemble complet de valeurs de propriétés associées à tout événement d´interface utilisateur. Tous les paramètres doivent être présents et configurés sur les valeurs par défaut (telles que false pour les drapeaux de touches booléens ou zéro pour les numéros de codes de nombres entiers) si les valeurs n´ont pas de signification pour le type d´événement.
Paramètres
Identificateur, sous forme de chaîne, d´un type d´événement, tel que DOMFocusIn, DOMFocusOut, DOMActivate. Valeur booléenne (true | false) déterminant si le comportement de propagation par défaut d´un événement est la remontée. Valeur booléenne (true | false) déterminant si l´action par défaut d´un événement peut être empêchée avec la méthode preventDefault( ). Référence à un objet fenêtre ou cadre dans lequel l´événement généré dynamiquement est censé s´être produit. Code, sous forme de nombre entier, des données détaillées associées à l'événement.
Valeur renvoyée
Aucune.

preventDefault( ) | NN 6 IE s.o DOM 2
Indique à l´événement courant d´ignorer l´opération normale qu´il effectue sur le noeud. Une fois configuré, ce mode ne peut pas être annulé pour l´événement courant. La fonction suivante d´auditeur d´événements Netscape 6 pour un événement keypress autorise la saisie de nombres dans un champ de texte uniquement:
    function numsOnly(evt) {
        if (evt.charCode< 48 || evt.charCode > 57) {
            evt.preventDefault( );
        }
    }
Cette méthode équivaut à affecter false à la propriété event.returnValue IE ou à ce que l´évaluation d´un gestionnaire d´événements soit return false.
Paramètres
Aucune.
Valeur renvoyée
Aucune.

stopPropagation( ) | NN 6 IE s.o DOM 2
Empêche l´événement courant de se propager dans la hiérarchie de capture ou de remontée au-delà du noeud en train de traiter l´événement. Cette méthode équivaut à affecter false à la propriété cancelBubble de l´objet événement (pour la propagation par remontée uniquement).
Paramètres
Aucune.
Valeur renvoyée
Aucune.