Text

Jump to:
  1. Constructor
  2. Properties
  3. Methods
  4. Specifications
  5. Browser compatibility
  6. See also

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 all Text nodes logically adjacent to this Node, 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

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support1 Yes Yes Yes Yes Yes
Text() constructor28 ?24 No158
isElementContentWhitespace No ? Yes — 10 No No No
wholeText1 Yes3.5 Yes Yes Yes
assignedSlot53 Yes Yes ?4010.1
replaceWholeText Yes — 45 ? Yes — 10 Yes Yes — 32 No
splitText11 Yes1 Yes Yes2 Yes3
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes ? ? Yes Yes Yes ?
Text() constructor2828 ?24158 ?
isElementContentWhitespace No No ? Yes — 10 No No ?
wholeText Yes ? ?4 Yes Yes ?
assignedSlot5353 Yes Yes4010.1 ?
replaceWholeText Yes — 45 Yes — 45 ? Yes — 10 Yes — 32 No ?
splitText Yes1181 ?4 Yes2 Yes3 ?

1. Before Chrome 30, the offset argument was optional.

2. Before Opera 17, the offset argument was optional.

3. The offset argument is optional.

See also

Document Tags and Contributors

Tags: 
Contributors to this page: fscholz, chrisdavidmills, Sebastianz, Kanaye, DomenicDenicola, stevenwdv, mattwojo, jpmedley, teoli, maybe, MHasan, Sheppy, Jürgen Jeka, jswisher, Ruakh, Brettz9
Last updated by: fscholz,