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.