Text

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.

Constructeur

Text()
Retourne un noeud Text avec le paramètre comme contenu textuel.

Propriétés

Hérite des propriétés de son parent CharacterData.

Text.isElementContentWhitespace Lecture seule

Renvoie une marque Boolean indiquant si le noeud de texte contient uniquement des espaces.

Text.wholeText Lecture seule
Renvoie une DOMString (chaîne de caractères) contenant le texte de tous les noeuds Text adjacents logiquement à ce Node, concaténé dans l'ordre du document.
Text.assignedSlot Lecture seule
Retourne l'objet HTMLSlotElement  associé à 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

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

Voir aussi