L'interface Text représente le contenu textuel d'un élément Element ou d'un attribut Attr. Si un élément n'a pas de balisage dans son contenu, il a un seul enfant implémentant Text qui contient le texte de l'élément. Par contre, si l'élément contient un balisage, il est analysé par les éléments d'information et les noeuds Text qui sont ses enfants.
Un nouveau document a un unique noeud Text pour chaque bloc de texte. Au fil du temps, d'autres noeuds peuvent être créés Text en temps que modification du contenu du document. La méthode Node.normalize() fusionne les objets Text dans un seul noeud pour chaque bloc de texte.
<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="#fff" 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><polyline points="396,25 406,20 406,30 396,25" stroke="#D4DDE4" fill="none"/><line x1="406" y1="25" x2="436" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/fr/docs/Web/API/Text" target="_top"><rect x="436" y="1" width="75" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="473.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Text</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
Constructeur
Text()- Retourne un noeud
Textavec le paramètre comme contenu textuel.
Propriétés
Hérite des propriétés de son parent CharacterData.
Text.isElementContentWhitespaceLecture seule-
Renvoie une marque
Booleanindiquant si le noeud de texte contient uniquement des espaces. Text.wholeTextLecture seule- Renvoie une
DOMString(chaîne de caractères) contenant le texte de tous les noeudsTextadjacents logiquement à ceNode, concaténé dans l'ordre du document. Text.assignedSlotLecture seule- Retourne l'objet
HTMLSlotElementassocié à l'élément.
Méthodes
Hérite des méthodes de son parent CharacterData.
Text.replaceWholeText- Remplace le texte du noeud en cours et tous les noeuds logiquement adjacents avec le texte spécifié.
Text.splitText- Fractionne le noeud en deux noeuds selon un décalage spécifié.
Spécifications
| Spécification | Statut | Commentaire |
|---|---|---|
| DOM La définition de 'Text' dans cette spécification. |
Standard évolutif | Suppression de la propriété isElementContentWhitespace.Suppression de la méthode replaceWholeText().Ajout du constructeur Text().Ajout de la propriété assignedSlot. |
| Document Object Model (DOM) Level 3 Core Specification La définition de 'Text' dans cette spécification. |
Obsolete | Ajout des propriétés isElementContentWhitespace et wholeText.Ajout de la méthode replaceWholeText(). |
| Document Object Model (DOM) Level 2 Core Specification La définition de 'Text' 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 'Text' dans cette spécification. |
Obsolete | Définition initiale. |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | 1.0 [3] | (Oui) | 1.0 (1.7 ou moins) | (Oui) | (Oui) [3] | (Oui) [4] |
wholeText |
1.0 | (Oui) | 3.5 (1.9.1) | (Oui) | (Oui) | (Oui) |
isElementContentWhitespace |
Pas de support | (Oui) | (Oui) Removed in 10 (10) |
Pas de support | Pas de support | Pas de support |
replaceWholeText |
(Oui) [1] [2] | (Oui) | 3.5 (1.9.1) Removed in 10 (10) |
(Oui) | (Oui) [1] [2] | (Oui) [4] |
Text() constructor |
28.0 | (Oui) | 24.0 (24.0) | Pas de support | 15.0 | Pas de support |
| Fonctionnalité | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | (Oui) [3] | (Oui) | 1.0 (1.0) | (Oui) | (Oui) [3] | (Oui) [4] |
wholeText |
(Oui) | (Oui) | 1.0 (1.9.1) | (Oui) | (Oui) | (Oui) |
isElementContentWhitespace |
Pas de support | (Oui) | (Oui) Removed in 10.0 (10) |
Pas de support | Pas de support | Pas de support |
replaceWholeText |
(Oui) [1] [2] | (Oui) | 1.0 (1.9.1) Removed in 10.0 (10) |
(Oui) | (Oui) [1] [2] | (Oui) [4] |
Text() constructor |
(Oui) | (Oui) | 24.0 (24.0) | Pas de support | 15.0 | Pas de support |
[1] Chromium envisage actuellement de laisser tomber son support.
[2] Avant Chrome 30 et Opera 17, l'argument n'était pas obligatoire, comme requis par la spécification.
[3] Avant Chrome 30 et Opera 17, l'argument splitText() n'était pas obligatoire, tel que requis par la spécification et mis en œuvre par les navigateurs IE et Gecko.
[4] L'argument n'est pas obligatoire, bien que requis par la spécification.