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

Sujets associés
  1. Document Object Model
  2. Text
  3. Constructeur
    1. Text() [Traduire]
  4. Propriétés
    1. assignedSlot [Traduire]
    2. isElementContentWhitespace [Traduire]
    3. wholeText [Traduire]
  5. Méthodes
    1. replaceWholeText() [Traduire]
    2. splitText()
  6. Héritage :
    1. CharacterData
    2. Node
    3. EventTarget
  7. Pages liées à DOM
    1. AbortController
    2. AbortSignal
    3. Attr
    4. ByteString
    5. CDATASection
    6. CSSPrimitiveValue
    7. CSSValue
    8. CSSValueList
    9. CharacterData
    10. ChildNode
    11. Comment
    12. CustomEvent
    13. DOMConfiguration
    14. DOMError
    15. DOMErrorHandler
    16. DOMException
    17. DOMImplementation
    18. DOMImplementationList
    19. DOMImplementationRegistry
    20. DOMImplementationSource
    21. DOMLocator
    22. DOMObject
    23. DOMParser
    24. DOMPoint
    25. DOMPointInit
    26. DOMPointReadOnly
    27. DOMRect
    28. DOMString
    29. DOMTimeStamp
    30. DOMTokenList
    31. DOMUserData
    32. Document
    33. DocumentFragment
    34. DocumentType
    35. Element
    36. ElementTraversal
    37. Entity
    38. EntityReference
    39. Event
    40. EventTarget
    41. HTMLCollection
    42. MutationObserver
    43. Node
    44. NodeFilter
    45. NodeIterator
    46. NodeList
    47. NonDocumentTypeChildNode
    48. ProcessingInstruction
    49. PromiseResolver
    50. Range
    51. TextDecoder
    52. TextEncoder
    53. TimeRanges
    54. TreeWalker
    55. TypeInfo
    56. USVString
    57. UserDataHandler
    58. XMLDocument