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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 1Edge Full support YesFirefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android ? Edge Mobile ? Firefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android ?
Text() constructor
Experimental
Chrome Full support 28Edge ? Firefox Full support 24IE No support NoOpera Full support 15Safari Full support 8WebView Android Full support YesChrome Android Full support 28Edge Mobile ? Firefox Android Full support 24Opera Android Full support 15Safari iOS Full support 8Samsung Internet Android ?
isElementContentWhitespace
Deprecated
Chrome No support NoEdge ? Firefox No support ? — 10IE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android No support NoEdge Mobile ? Firefox Android No support ? — 10Opera Android No support NoSafari iOS No support NoSamsung Internet Android ?
wholeTextChrome Full support 1Edge Full support YesFirefox Full support 3.5IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android ? Edge Mobile ? Firefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android ?
assignedSlotChrome Full support 53Edge Full support YesFirefox Full support YesIE ? Opera Full support 40Safari Full support 10.1WebView Android Full support 53Chrome Android Full support 53Edge Mobile Full support YesFirefox Android Full support YesOpera Android Full support 40Safari iOS Full support 10.1Samsung Internet Android ?
replaceWholeText
DeprecatedNon-standard
Chrome No support ? — 45Edge ? Firefox No support ? — 10IE Full support YesOpera No support ? — 32Safari No support NoWebView Android No support ? — 45Chrome Android No support ? — 45Edge Mobile ? Firefox Android No support ? — 10Opera Android No support ? — 32Safari iOS No support NoSamsung Internet Android ?
splitTextChrome Full support 1
Notes
Full support 1
Notes
Notes Before Chrome 30, the offset argument was optional.
Edge Full support YesFirefox Full support 1IE Full support YesOpera Full support Yes
Notes
Full support Yes
Notes
Notes Before Opera 17, the offset argument was optional.
Safari Full support Yes
Notes
Full support Yes
Notes
Notes The offset argument is optional.
WebView Android Full support Yes
Notes
Full support Yes
Notes
Notes Before version 4.4, the offset argument was optional.
Chrome Android Full support 18
Notes
Full support 18
Notes
Notes Before Chrome 30, the offset argument was optional.
Edge Mobile ? Firefox Android Full support 4Opera Android Full support Yes
Notes
Full support Yes
Notes
Notes Before Opera 17, the offset argument was optional.
Safari iOS Full support Yes
Notes
Full support Yes
Notes
Notes The offset argument is optional.
Samsung Internet Android ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.
See implementation notes.
See implementation notes.

See also

Document Tags and Contributors

Tags: 
Last updated by: fscholz,