The Text
interface represents the textual content of Element
or Attr
.
If an element has no markup within its content, it has a single child implementing Text
that contains the element's text. However, if the element contains markup, it is parsed into information items and Text
nodes that form its children.
New documents have a single Text
node for each block of text. Over time, more Text
nodes may be created as the document's content changes. The Node.normalize()
method merges adjacent Text
objects back into a single node for each block of text.
Constructor
Text()
- Returns a
Text
node with the parameter as its textual content.
Properties
Inherits properties from its parent, CharacterData
.
Text.isElementContentWhitespace
Read only-
Returns a
Boolean
flag indicating whether or not the text node contains only whitespace. Text.wholeText
Read only- Returns a
DOMString
containing the text of allText
nodes logically adjacent to thisNode
, concatenated in document order. Text.assignedSlot
Read only- Returns the
HTMLSlotElement
object associated with the element.
Properties included from Slotable
The Text
interface includes the following property, defined on the Slotable
mixin.
Slotable.assignedSlot
Read only- Returns a
HTMLSlotElement
representing the<slot>
the node is inserted in.
Methods
Inherits methods from its parent, CharacterData
.
Text.replaceWholeText
- Replaces the text of the current node and all logically adjacent nodes with the specified text.
Text.splitText
- Breaks the node into two nodes at a specified offset.
Specifications
Specification | Status | Comment |
---|---|---|
DOM The definition of 'Text' in that specification. |
Living Standard | Removed the isElementContentWhitespace property.Removed the replaceWholeText() method.Added the Text() constructor.Added the assignedSlot property. |
Document Object Model (DOM) Level 3 Core Specification The definition of 'Text' in that specification. |
Obsolete | Added the isElementContentWhitespace and wholeText properties.Added the replaceWholeText() method. |
Document Object Model (DOM) Level 2 Core Specification The definition of 'Text' in that specification. |
Obsolete | No change from Document Object Model (DOM) Level 1 Specification. |
Document Object Model (DOM) Level 1 Specification The definition of 'Text' in that specification. |
Obsolete | Initial definition. |
Browser compatibility
BCD tables only load in the browser