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.

Renvoie true si la touche Alt gauche ou droite est enfoncée au moment du déclenchement de l´événement.

Renvoie true si la touche Alt à gauche est enfoncée au moment du déclenchement de l´événement.

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.

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.

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.

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.

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.

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( ).

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.

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.

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.

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.

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.

Renvoie true si la touche Ctrl de gauche est enfoncée au moment du déclenchement de l´événement.

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.

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.

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.

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.

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).

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.

Renvoie une référence à l'objet, là où le curseur se trouvait juste avant l'événement onMouseOver ou onMouseOut.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Voir newValue.

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.

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.

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).

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.

Renvoie une référence à un objet recordset de liaison de données IE associé à un événement ayant trait aux données.

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.

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.

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.

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.

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.

Renvoie true si la touche Maj gauche ou droite est enfoncée au moment du déclenchement de l´événement.

Renvoie true si la touche Maj gauche est enfoncée au moment du déclenchement de l´événement.

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.

Référence à l'objet filtre qui a déclenché un événement onfilterchange.

Chaîne de l´URN d´un comportement associé qui a déclenché un événement.

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.

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.

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.

Indique le type de l'événement courant (sans le préfixe "on"). Les valeurs sont toutes en lettres minuscules.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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( );
    }
} 

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).