Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Text

Baseline
Large disponibilité
*

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

L'interface Text représente un nœud de texte node dans un arbre DOM.

EventTarget Node CharacterData Text

Pour comprendre ce qu'est un nœud de texte, considérez le document suivant :

html
<html lang="fr" class="e">
  <head>
    <title>Des extraterrestres&nbsp;?</title>
  </head>
  <body>
    Bien sûr.
  </body>
</html>

Dans ce document, il y a cinq nœuds de texte, avec les contenus suivants (tous les espaces sont affichés comme et tous les sauts de ligne comme ) :

  • "⏎◦◦◦◦" (après la balise d'ouverture <head>, un saut de ligne suivi de quatre espaces)
  • "Extraterrestres◦?" (le contenu de l'élément <title>)
  • "⏎◦◦" (après la balise de fermeture </title>, un saut de ligne suivi de deux espaces)
  • "⏎◦◦" (après la balise de fermeture </head>, un saut de ligne suivi de deux espaces)
  • "⏎◦◦◦◦Bien◦sûr.⏎◦◦⏎" (le contenu de l'élément <body>)

Chacun de ces nœuds de texte est un objet qui possède les propriétés et méthodes documentées dans cet article.

Constructeur

Text()

Retourne un nouveau nœud Text avec pour paramètre son contenu textuel.

Propriétés d'instance

Hérite des propriétés de ses parents, CharacterData, Node et EventTarget.

Text.assignedSlot Lecture seule

Retourne un objet HTMLSlotElement représentant le <slot> dans lequel le nœud est inséré.

Text.wholeText Lecture seule

Retourne une chaîne de caractères contenant le texte de tous les nœuds Text adjacents logiquement à ce Node, concaténé dans l'ordre du document.

Méthodes d'instance

Hérite des méthodes de son parent, CharacterData, Node et EventTarget.

Text.splitText

Fractionne le nœud en deux nœuds selon un décalage défini.

Spécifications

Spécification
DOM
# interface-text

Compatibilité des navigateurs

Voir aussi