Interface: CharacterData

Description: Interface qui possède un ensemble d'attributs et de méthodes pour accéder à des caractères.Aucun objet DOM ne peut correspondre directement avec cette interface


Hérite de: Node

Sous-Interfaces: dom::Comment, dom::Text


Pour la majorité des méthodes, lorsque la somme des attributs offset et count excède la longueur de la chaîne, tous les caractères (à partir de l'offset) jusqu'à la fin sont retournés ou traités selon l'opération.

Exemple

var texte = document.createTextNode('abc def ghi');

alert( 
"Valeur: "+ texte.data +
"\nLongueur: "+ texte.length + 
"\nsubstringData(1,5): " + texte.substringData(1,5)
);

var str = "Data: " + texte.data;
texte.appendData('|append|');
str += "\nAppend:" + texte.data;

texte.insertData(3, '|insert|');
str += "\nInsert:" + texte.data;

texte.deleteData(1, 4);
str += "\nDelete:" + texte.data;

texte.replaceData(1, 4, "[replaceData]");
str += "\nReplace:" + texte.data;

alert( str );

Test: XHTML


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.
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.