L'interface abstraite CharacterData représente un objet Node (noeud) qui contient des caractères. C'est une interface abstraite, ce qui signifie qu'il n'existe aucun objet de type CharacterData : elle est implémentée par d'autres interfaces comme Text, Comment ou ProcessingInstruction qui ne sont pas abstraites.
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/fr/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/fr/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/fr/docs/Web/API/CharacterData" target="_top"><rect x="266" y="1" width="130" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="331" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">CharacterData</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
Propriétés
Hérite des propriétés de son parent Node et implémente les interfaces ChildNode et NonDocumentTypeChildNode.
CharacterData.data- est une
DOMString(chaîne de caractères) representant les données textuelles contenues dans cet objet. CharacterData.lengthLecture seule- Retourne un
unsigned longreprésentant la taille de la chaîne de caractères contenue dansCharacterData.data. NonDocumentTypeChildNode.nextElementSiblingLecture seule- Retourne l'
Elementimmédiatement après celui spécifié dans la liste des enfants de son parent, ounullsi l'élément spécifié est le dernier de la liste. NonDocumentTypeChildNode.previousElementSiblingLecture seule- Retourne l'
Elementimmédiatement avant celui spécifié dans la liste des enfants de son parent, ounullsi l'élément spécifié est le premier de la liste.
Méthodes
Hérite des méthodes de son parent Node, et implémente les interfaces ChildNode et NonDocumentTypeChildNode.
CharacterData.appendData()- Ajoute la
DOMString(chaîne de caractères) donnée à la chaîneCharacterData.data; dans le retour de la méthode,datacontient laDOMStringconcaténée . CharacterData.deleteData()- Supprime la quantité spécifiée de caractères, en commençant au point désigné, à partir de la chaîne
CharacterData.data; dans le retour de la méthode,datacontient le raccourciDOMString. CharacterData.insertData()- Insère les caractères spécifiés, au point désigné, dans la chaîne
CharacterData.data; dans le retour de cette méthode,datacontient laDOMString(chaîne de caractères) modifiée. ChildNode.remove()- Supprime l'objet de la liste d'enfants de son parent.
CharacterData.replaceData()- Remplace la quantité spécifiée de caractères, en commençant au point désigné, avec la
DOMString(chaîne de caractères) spécifiée ; dans le retour de cette méthode,datacontient laDOMStringmodifiée. CharacterData.substringData()- Renvoie une
DOMString(chaîne de caractères) contenant la partie deCharacterData.datade la longueur spécifiée et commençant au point désigné.
Spécifications
| Spécification | Statut | Commentaire |
|---|---|---|
| DOM La définition de 'CharacterData' dans cette spécification. |
Standard évolutif | Ajoute une implémention des interfaces ChildNode etNonDocumentTypeChildNode. |
| Document Object Model (DOM) Level 3 Core Specification La définition de 'CharacterData' dans cette spécification. |
Obsolete | Pas de changement depuis Document Object Model (DOM) Level 2 Core Specification. |
| Document Object Model (DOM) Level 2 Core Specification La définition de 'CharacterData' dans cette spécification. |
Obsolete | Pas de changement depuis Document Object Model (DOM) Level 1 Specification. |
| Document Object Model (DOM) Level 1 Specification La définition de 'CharacterData' dans cette spécification. |
Obsolete | Définition initiale. |
Compatibilité des navigateurs
Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !
| Fonctionnalité | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | 1.0 | (Oui) | 1.0 (1.7 ou moins) | 6 | (Oui) | (Oui) |
Implements ChildNode interface. |
? | (Oui) | 25.0 (25.0) [1] | Pas de support | ? | Pas de support |
| Fonctionnalité | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | (Oui) | (Oui) | 1.0 (1.0) | (Oui) | (Oui) | (Oui) |
Implements ChildNode interface. |
? | (Oui) | 25.0 (25.0) [1] | Pas de support | ? | Pas de support |
[1] Les deux propriétés nextElementSibling et previousElementSibling ont été déplacées vers l'interface NonDocumentTypeChildNode, également implémentée par CharacterData.