Interface: CDATASection

Description: Les sections CDATA sont utilisés pour contenir des caractères qui devrait être normalement échappé par le langage de balisage.


Hérite de: Text


Le seul délimiteur qui est reconnu dans les sections CCDATA est la chaîne "]]>" qui termine la section. Les sections CDATA ne peuvent pas être imbriquées une dans l'autre. Son but principal est d'inclure des fragments XML sans utitlisé des caractères d'échappements comme < ou > en autre.

L'attribut DOMString du noeud Text représente le texte qui est contenu dans la section CDATA. Noter que cette chaîne peut contenir des caractères qui peut être échappé à l'extérieur des sections CDATA dépendamment de l'encodage choisit. Il peut même être impossible d'écrire quelques caractères dans des sections CDATA.

L'interface CDATASection hérite de l'interface CharacterData via l'interface Text. Cependant, les noeuds CDATASection ne sont pas fusionné avec la méthode Element.normalize().

Voir la méthode createCDATASection() de l'interface Document pour un exemple d'utilisation.


Attributs

Lecture SeuleTypeNomDescription
OUI NamedNodeMap attributes
Un objet NamedNodeMap contenant tous les attributs du noeud (si le noeud est un Element).
OUI NodeList childNodes
Un NodeList contient tous les enfants du noeud. S'il n'y a pas d'enfant, le NodeList existe mais ne contient aucun noeud. (NodeList.length=0)
DOMString data
Les données (caractère) du noeud qui implémente cette interface.
OUI Node firstChild
Le premier noeud enfant de ce noeud. S'il n'y a pas d'enfant, retourne null.
OUI Node lastChild
Le dernier noeud enfant de ce noeud. S'il n'y a pas d'enfant, retourne null.
OUI unsigned long length
Le nombre de caractères accessibles pour l'attribut data et la méthode substringData().
OUI Node nextSibling
Le noeud qui suit immédiatement (après) le noeud courant. S'il n'existe pas, l'attribut est null.
OUI DOMString nodeName
Le nom du noeud. Voir la table (interface Node).
OUI unsigned short nodeType
Un code (entier) qui représente le type de noeud.
DOMString nodeValue
La valeur d'un noeud selon le type de Noeud. (Voir la table dans l'interface Node).
OUI Document ownerDocument
L'objet Document associé à un noeud. C'est aussi l'objet permettant de créer de nouveaux noeuds. Lorsque ce noeud est un Document, l'attribut est null.
OUI Node parentNode
Le parent du noeud. Tous les noeuds peuvent avoir un noeud parent. Exception faite de : Document, DocumentFragment et Attr.
OUI Node previousSibling
Le noeud précédent immédiatement le noeud courant. S'il n'existe pas, l'attribut est null.

Méthodes

RetourNomDescription
Node appendChild
Ajoute un noeud newChild à la fin de la liste des enfants du noeud courant. Si newChild est déjà dans l'arbre, il est premièrement enlevé.
void appendData
Ajoute à la fin des caractères une chaîne au noeud.
Node cloneNode
Retourne un clone d'un noeud. On peut s'en servir pour construire des copies conforme de noeuds. Le nouveau noeud n'a pas de parent (parentNode=null).
void deleteData
Enlève une série de caractères du noeud.
boolean hasChildNodes
C'est une méthode utile pour déterminer si un noeud possède des noeud-enfants.
Node insertBefore
Insère le noeud newChild avant le noeud-enfant existant refChild. Si refChild est null, le nouveau noeud est insérer à la fin de la liste des noeud-enfants.
void insertData
Insère à une position spécifique une chaîne de caractères.
Node removeChild
Enlève un noeud-enfant indiqué par oldChild de la liste des enfants, et le retourne.
Node replaceChild
Remplace l'ancien noeud (oldChild) avec le nouveau noeud (newChild) et retourne l'ancien noeud (oldChild).
void replaceData
Replace une série de caractères spécifiée par une position de départ et une longueur par une nouvelle chaîne de caractères.
Text splitText
Sépare en deux noeuds Text ce noeud à la position définie. Les deux sont accessibles dans l'arbre en utilisant les méthodes de "sibling".
DOMString substringData
Extrait une série de données du noeud.

Constantes

ELEMENT_NODE 1 Le noeud est un Element
DOCUMENT_TYPE_NODE 10 Le noeud est un DocumentType
DOCUMENT_FRAGMENT_NODE 11 Le noeud est un DocumentFragment
NOTATION_NODE 12 Le noeud est une Notation
ATTRIBUTE_NODE 2 Le noeud est un Attr
TEXT_NODE 3 Le noeud est un Text
CDATA_SECTION_NODE 4 Le noeud est une CDATASection
ENTITY_REFERENCE_NODE 5 Le noeud est une EntityReference
ENTITY_NODE 6 Le noeud est une Entity
PROCESSING_INSTRUCTION_NODE 7 Le noeud est une ProcessingInstruction
COMMENT_NODE 8 Le noeud est un Comment
DOCUMENT_NODE 9 Le noeud est un Document

Afficher IDL: court / long

Notes et commentaires des visiteurs

Ajouter une note

Aucun commentaire jusqu'à présent.