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