dom : DOM Level 1 |
Attributs | Méthodes | Constantes | Interfaces | IDL | + |
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 Seule | Type | Nom | Description |
|---|---|---|---|
| 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
| Retour | Nom | Description |
|---|---|---|
| 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 |
Notes et commentaires des visiteurs
Ajouter une note
Aucun commentaire jusqu'à présent.