Lisez-moi S.V.P. 

13 novembre 2000

Annexe C : La liaison avec le langage ECMAScript

Cette annexe contient la liaison ECMAScript complète [ECMAScript] pour les définitions du modèle objet de document niveau 2 Traversal et Range. Les définitions se répartissent entre les fonctionnalités Traversal et Range.

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

C.1 : Le modèle objet de document Traversal

Objet NodeIterator
L'objet NodeIterator a les propriétés suivantes :
root
Cette propriété en lecture seule est du type Node.
whatToShow
Cette propriété en lecture seule est du type Number.
filter
Cette propriété en lecture seule est du type NodeFilter.
expandEntityReferences
Cette propriété en lecture seule est du type Boolean.
L'objet NodeIterator a les méthodes suivantes :
nextNode()
Cette méthode retourne un objet de type Node.
Cette méthode peut soulever une exception DOMException.
previousNode()
Cette méthode retourne un objet de type Node.
Cette méthode peut soulever une exception DOMException.
detach()
Cette méthode ne retourne aucune valeur.
Objet prototype NodeFilter
La classe NodeFilter a les constantes suivantes :
NodeFilter.FILTER_ACCEPT
Cette constante est du type short et sa valeur est 1.
NodeFilter.FILTER_REJECT
Cette constante est du type short et sa valeur est 2.
NodeFilter.FILTER_SKIP
Cette constante est du type short et sa valeur est 3.
NodeFilter.SHOW_ALL
Cette constante est du type Number et sa valeur est 0xFFFFFFFF.
NodeFilter.SHOW_ELEMENT
Cette constante est du type Number et sa valeur est 0x00000001.
NodeFilter.SHOW_ATTRIBUTE
Cette constante est du type Number et sa valeur est 0x00000002.
NodeFilter.SHOW_TEXT
Cette constante est du type Number et sa valeur est 0x00000004.
NodeFilter.SHOW_CDATA_SECTION
Cette constante est du type Number et sa valeur est 0x00000008.
NodeFilter.SHOW_ENTITY_REFERENCE
Cette constante est du type Number et sa valeur est 0x00000010.
NodeFilter.SHOW_ENTITY
Cette constante est du type Number et sa valeur est 0x00000020.
NodeFilter.SHOW_PROCESSING_INSTRUCTION
Cette constante est du type Number et sa valeur est 0x00000040.
NodeFilter.SHOW_COMMENT
Cette constante est du type Number et sa valeur est 0x00000080.
NodeFilter.SHOW_DOCUMENT
Cette constante est du type Number et sa valeur est 0x00000100.
NodeFilter.SHOW_DOCUMENT_TYPE
Cette constante est du type Number et sa valeur est 0x00000200.
NodeFilter.SHOW_DOCUMENT_FRAGMENT
Cette constante est du type Number et sa valeur est 0x00000400.
NodeFilter.SHOW_NOTATION
Cette constante est du type Number et sa valeur est 0x00000800.
Objet NodeFilter
C'est une fonction de référence ECMAScript. Cette méthode retourne une valeur de type Number. Le paramètre est du type Node.
Objet TreeWalker
L'objet TreeWalker a les propriétés suivantes :
root
Cette propriété en lecture seule est du type Node.
whatToShow
Cette propriété en lecture seule est du type Number.
filter
Cette propriété en lecture seule est du type NodeFilter.
expandEntityReferences
Cette propriété en lecture seule est du type Boolean.
currentNode
Cette propriétés est du type Node et peut soulever une exception DOMException à l'initialisation.
L'objet TreeWalker a les méthodes suivantes :
parentNode()
Cette méthode retourne un objet de type Node.
firstChild()
Cette méthode retourne un objet de type Node.
lastChild()
Cette méthode retourne un objet de type Node.
previousSibling()
Cette méthode retourne un objet de type Node.
nextSibling()
Cette méthode retourne un objet de type Node.
previousNode()
Cette méthode retourne un objet de type Node.
nextNode()
Cette méthode retourne un objet de type Node.
Objet DocumentTraversal
L'objet DocumentTraversal a les méthodes suivantes :
createNodeIterator(root, whatToShow, filter, entityReferenceExpansion)
Cette méthode retourne un objet de type NodeIterator.
Le paramètre root est du type Node.
Le paramètre whatToShow est du type Number.
Le paramètre filter est du type NodeFilter.
Le paramètre entityReferenceExpansion est du type Boolean.
Cette méthode peut soulever une exception DOMException.
createTreeWalker(root, whatToShow, filter, entityReferenceExpansion)
Cette méthode retourne un objet de type TreeWalker.
Le paramètre root est du type Node.
Le paramètre whatToShow est du type Number.
Le paramètre filter est du type NodeFilter.
Le paramètre entityReferenceExpansion est du type Boolean.
Cette méthode peut soulever une exception DOMException.

C.2 : Le modèle objet de document Range

Objet prototype Range
La classe Range a les constantes suivantes :
Range.START_TO_START
Cette constante est du type Number et sa valeur est 0.
Range.START_TO_END
Cette constante est du type Number et sa valeur est 1.
Range.END_TO_END
Cette constante est du type Number et sa valeur est 2.
Range.END_TO_START
Cette constante est du type Number et sa valeur est 3.
Objet Range
L'objet Range a les propriétés suivantes :
startContainer
Cette propriété en lecture seule est du type Node et peut soulever une exception DOMException en retour.
startOffset
Cette propriété en lecture seule est du type long et peut soulever une exception DOMException en retour.
endContainer
Cette propriété en lecture seule est du type Node et peut soulever une exception DOMException en retour.
endOffset
Cette propriété en lecture seule est du type long et peut soulever une exception DOMException en retour.
collapsed
Cette propriété en lecture seule est du type Boolean et peut soulever une exception DOMException en retour.
commonAncestorContainer
Cette propriété en lecture seule est du type Node et peut soulever une exception DOMException en retour.
L'objet Range a les méthodes suivantes :
setStart(refNode, offset)
Cette méthode ne retourne aucune valeur.
Le paramètre refNode est du type Node.
Le paramètre offset est du type long.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
setEnd(refNode, offset)
Cette méthode ne retourne aucune valeur.
Le paramètre refNode est du type Node.
Le paramètre offset est du type long.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
setStartBefore(refNode)
Cette méthode ne retourne aucune valeur.
Le paramètre refNode est du type Node.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
setStartAfter(refNode)
Cette méthode ne retourne aucune valeur.
Le paramètre refNode est du type Node.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
setEndBefore(refNode)
Cette méthode ne retourne aucune valeur.
Le paramètre refNode est du type Node.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
setEndAfter(refNode)
Cette méthode ne retourne aucune valeur.
Le paramètre refNode est du type Node.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
collapse(toStart)
Cette méthode ne retourne aucune valeur.
Le paramètre toStart est du type Boolean.
Cette méthode peut soulever une exception DOMException.
selectNode(refNode)
Cette méthode ne retourne aucune valeur.
Le paramètre refNode est du type Node.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
selectNodeContents(refNode)
Cette méthode ne retourne aucune valeur.
Le paramètre refNode est du type Node.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
compareBoundaryPoints(how, sourceRange)
Cette méthode retourne un objet de type short.
Le paramètre how est du type Number.
Le paramètre sourceRange est du type Range.
Cette méthode peut soulever une exception DOMException.
deleteContents()
Cette méthode ne retourne aucune valeur.
Cette méthode peut soulever une exception DOMException.
extractContents()
Cette méthode retourne un objet de type DocumentFragment.
Cette méthode peut soulever une exception DOMException.
cloneContents()
Cette méthode retourne un objet de type DocumentFragment.
Cette méthode peut soulever une exception DOMException.
insertNode(newNode)
Cette méthode ne retourne aucune valeur.
Le paramètre newNode est du type Node.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
surroundContents(newParent)
Cette méthode ne retourne aucune valeur.
Le paramètre newParent est du type Node.
Cette méthode peut soulever une exception RangeException ou du type DOMException.
cloneRange()
Cette méthode retourne un objet de type Range.
Cette méthode peut soulever une exception DOMException.
toString()
Cette méthode retourne un objet de type String.
Cette méthode peut soulever une exception DOMException.
detach()
Cette méthode ne retourne aucune valeur.
Cette méthode peut soulever une exception DOMException.
Objet DocumentRange
L'objet DocumentRange a les méthodes suivantes :
createRange()
Cette méthode retourne un objet de type Range.
Objet prototype RangeException
La classe RangeException a les constantes suivantes :
RangeException.BAD_BOUNDARYPOINTS_ERR
Cette constante est du type Number et sa valeur est 1.
RangeException.INVALID_NODE_TYPE_ERR
Cette constante est du type Number et sa valeur est 2.
Objet RangeException
L'objet RangeException a les propriétés suivantes :
code
Cette propriété est du type Number.