Lisez-moi S.V.P. 

13 novembre 2000

Annexe C : La liaison avec le langage ECMAScript

Cette annexe contient la liaison ECMAScript [ECMAScript] complète pour le modèle objet de document niveau 2 Events.

Remarque : Les exceptions ne sont gérées que par les mises en œuvre ECMAScript conformes au standard ECMA-262 3e édition ([ECMAScript]).

Objet EventTarget
L'objet EventTarget a les méthodes suivantes :
addEventListener(type, listener, useCapture)
Cette méthode ne retourne aucune valeur.
Le paramètre type est du type String.
Le paramètre listener est un objet EventListener.
Le paramètre useCapture est du type Boolean.
removeEventListener(type, listener, useCapture)
Cette méthode ne retourne aucune valeur.
Le paramètre type est du type String.
Le paramètre listener est un objet EventListener.
Le paramètre useCapture est du type Boolean.
dispatchEvent(evt)
Cette méthode retourne une valeur de type Boolean.
Le paramètre evt est un objet Event.
Cette méthode peut soulever une exception EventException.
Objet EventListener
C'est un appel de fonction ECMAScript. Cette méthode ne retourne aucune valeur. Le paramètre est un objet Event.
Objet prototype Event
La classe Event a les constantes suivantes :
Event.CAPTURING_PHASE
Cette constante est du type Number et sa valeur est 1.
Event.AT_TARGET
Cette constante est du type Number et sa valeur est 2.
Event.BUBBLING_PHASE
Cette constante est du type Number et sa valeur est 3.
Objet Event
L'objet Event a les propriétés suivantes :
type
Cette propriété en lecture seule est du type String.
target
Cette propriété en lecture seule est un objet EventTarget.
currentTarget
Cette propriété en lecture seule est un objet EventTarget.
eventPhase
Cette propriété en lecture seule est du type Number.
bubbles
Cette propriété en lecture seule est du type Boolean.
cancelable
Cette propriété en lecture seule est du type Boolean.
timeStamp
Cette propriété en lecture seule est un objet Date.
L'objet Event a les méthodes suivantes :
stopPropagation()
Cette méthode ne retourne aucune valeur.
preventDefault()
Cette méthode ne retourne aucune valeur.
initEvent(eventTypeArg, canBubbleArg, cancelableArg)
Cette méthode ne retourne aucune valeur.
Le paramètre eventTypeArg est du type String.
Le paramètre canBubbleArg est du type Boolean.
Le paramètre cancelableArg est du type Boolean.
Objet prototype EventException
La classe EventException a les constantes suivantes :
EventException.UNSPECIFIED_EVENT_TYPE_ERR
Cette constante est du type Number et sa valeur est 0.
Objet EventException
L'objet EventException a les propriétés suivantes :
code
Cette propriété est du type Number.
Objet DocumentEvent
L'objet DocumentEvent a les méthodes suivantes :
createEvent(eventType)
Cette méthode retourne un objet Event.
Le paramètre eventType est du type String.
Cette méthode peut soulever une exception DOMException.
Objet UIEvent
L'objet UIEvent a toutes les propriétés et les méthodes de l'objet Event ainsi que celles définies ci-dessous.
L'objet UIEvent a les propriétés suivantes :
view
Cette propriété en lecture seule est un objet AbstractView.
detail
Cette propriété en lecture seule est un objet long.
L'objet UIEvent a les méthodes suivantes :
initUIEvent(typeArg, canBubbleArg, cancelableArg, viewArg, detailArg)
Cette méthode ne retourne aucune valeur.
Le paramètre typeArg est du type String.
Le paramètre canBubbleArg est du type Boolean.
Le paramètre cancelableArg est du type Boolean.
Le paramètre viewArg est un objet AbstractView.
Le paramètre detailArg est un objet long.
Objet MouseEvent
L'objet MouseEvent a toutes les propriétés et les méthodes de l'objet UIEvent ainsi que celles définies ci-dessous.
L'objet MouseEvent a les propriétés suivantes :
screenX
Cette propriété en lecture seule est un objet long.
screenY
Cette propriété en lecture seule est un objet long.
clientX
Cette propriété en lecture seule est un objet long.
clientY
Cette propriété en lecture seule est un objet long.
ctrlKey
Cette propriété en lecture seule est du type Boolean.
shiftKey
Cette propriété en lecture seule est du type Boolean.
altKey
Cette propriété en lecture seule est du type Boolean.
metaKey
Cette propriété en lecture seule est du type Boolean.
button
Cette propriété en lecture seule est du type Number.
relatedTarget
Cette propriété en lecture seule est un objet EventTarget.
L'objet MouseEvent a les méthodes suivantes :
initMouseEvent(typeArg, canBubbleArg, cancelableArg, viewArg, detailArg, screenXArg, screenYArg, clientXArg, clientYArg, ctrlKeyArg, altKeyArg, shiftKeyArg, metaKeyArg, buttonArg, relatedTargetArg)
Cette méthode ne retourne aucune valeur.
Le paramètre typeArg est du type String.
Le paramètre canBubbleArg est du type Boolean.
Le paramètre cancelableArg est du type Boolean.
Le paramètre viewArg est un objet AbstractView.
Le paramètre detailArg est un objet long.
Le paramètre screenXArg est un objet long.
Le paramètre screenYArg est un objet long.
Le paramètre clientXArg est un objet long.
Le paramètre clientYArg est un objet long.
Le paramètre ctrlKeyArg est du type Boolean.
Le paramètre altKeyArg est du type Boolean.
Le paramètre shiftKeyArg est du type Boolean.
Le paramètre metaKeyArg est du type Boolean.
Le paramètre buttonArg est du type Number.
Le paramètre relatedTargetArg est un objet EventTarget.
Objet prototype MutationEvent
La classe MutationEvent a les constantes suivantes :
MutationEvent.MODIFICATION
Cette constante est du type Number et sa valeur est 1.
MutationEvent.ADDITION
Cette constante est du type Number et sa valeur est 2.
MutationEvent.REMOVAL
Cette constante est du type Number et sa valeur est 3.
Objet MutationEvent
L'objet MutationEvent a toutes les propriétés et les méthodes de l'objet Event ainsi que celles définies ci-dessous.
L'objet MutationEvent a les propriétés suivantes :
relatedNode
Cette propriété en lecture seule est un objet Node.
prevValue
Cette propriété en lecture seule est du type String.
newValue
Cette propriété en lecture seule est du type String.
attrName
Cette propriété en lecture seule est du type String.
attrChange
Cette propriété en lecture seule est du type Number.
L'objet MutationEvent a les méthodes suivantes :
initMutationEvent(typeArg, canBubbleArg, cancelableArg, relatedNodeArg, prevValueArg, newValueArg, attrNameArg, attrChangeArg)
Cette méthode ne retourne aucune valeur.
Le paramètre typeArg est du type String.
Le paramètre canBubbleArg est du type Boolean.
Le paramètre cancelableArg est du type Boolean.
Le paramètre relatedNodeArg est un objet Node.
Le paramètre prevValueArg est du type String.
Le paramètre newValueArg est du type String.
Le paramètre attrNameArg est du type String.
Le paramètre attrChangeArg est du type Number.

Dans l'exemple suivant, un guetteur d'événement basé sur ECMAScript est ajouté au nœud 'noeudExemple' :

  // Soit le nœud 'noeudExemple'

  // Définit la fonction du guetteur d'événement
  function gestionnaireClick( evt ) 
  {
    // Contenu de la fonction 
  }

  // La ligne suivante ajoute un guetteur 'click' non capturant
  // au nœud 'noeudExemple'. 
  noeudExemple.addEventListener( "click", gestionnaireClick, false );