Text

Edit
Advanced
- History
- Print this article

Jump to:

Constructor
Properties
Methods
Specifications
Browser compatibility
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.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/CharacterData" target="_top"><rect x="266" y="1" width="130" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="331" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">CharacterData</text></a><polyline points="396,25  406,20  406,30  396,25" stroke="#D4DDE4" fill="none"/><line x1="406" y1="25" x2="436" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Text" target="_top"><rect x="436" y="1" width="75" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="473.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Text</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

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

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	iOS Safari	Samsung Internet
Basic support	Chrome Full support 1	Edge Full support Yes	Firefox Full support Yes	IE Full support Yes	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android ?	Edge Mobile ?	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android ?
`Text()` constructor Experimental	Chrome Full support 28	Edge ?	Firefox Full support 24	IE No support No	Opera Full support 15	Safari Full support 8	WebView Android Full support Yes	Chrome Android Full support 28	Edge Mobile ?	Firefox Android Full support 24	Opera Android Full support 15	Safari iOS Full support 8	Samsung Internet Android ?
`isElementContentWhitespace` Deprecated	Chrome No support No	Edge ?	Firefox No support ? — 10	IE No support No	Opera No support No	Safari No support No	WebView Android No support No	Chrome Android No support No	Edge Mobile ?	Firefox Android No support ? — 10	Opera Android No support No	Safari iOS No support No	Samsung Internet Android ?
`wholeText`	Chrome Full support 1	Edge Full support Yes	Firefox Full support 3.5	IE Full support Yes	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android ?	Edge Mobile ?	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android ?
`assignedSlot`	Chrome Full support 53	Edge Full support Yes	Firefox Full support Yes	IE ?	Opera Full support 40	Safari Full support 10.1	WebView Android Full support 53	Chrome Android Full support 53	Edge Mobile Full support Yes	Firefox Android Full support Yes	Opera Android Full support 40	Safari iOS Full support 10.1	Samsung Internet Android ?
`replaceWholeText` DeprecatedNon-standard	Chrome No support ? — 45	Edge ?	Firefox No support ? — 10	IE Full support Yes	Opera No support ? — 32	Safari No support No	WebView Android No support ? — 45	Chrome Android No support ? — 45	Edge Mobile ?	Firefox Android No support ? — 10	Opera Android No support ? — 32	Safari iOS No support No	Samsung Internet Android ?
`splitText`	Chrome Full support 1 Notes Full support 1 Notes Notes Before Chrome 30, the `offset` argument was optional.	Edge Full support Yes	Firefox Full support 1	IE Full support Yes	Opera 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 4	Opera 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.

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, Apr 13, 2018, 5:07:08 AM