W3cubDocs

Text

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 compatibilityUpdate compatibility data on GitHub

	Desktop
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari
Basic support	1	Yes	Yes	Yes	Yes	Yes
`Text()` constructor	28	?	24	No	15	8
`isElementContentWhitespace`	No	?	? — 10	No	No	No
`wholeText`	1	Yes	3.5	Yes	Yes	Yes
`assignedSlot`	53	Yes	Yes	?	40	10.1
`replaceWholeText`	? — 45	?	? — 10	Yes	? — 32	No
`splitText`	1 1 Before Chrome 30, the `offset` argument was optional.	Yes	1	Yes	Yes Yes Before Opera 17, the `offset` argument was optional.	Yes Yes The `offset` argument is optional.

	Mobile
	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	iOS Safari	Samsung Internet
Basic support	Yes	?	?	Yes	Yes	Yes	?
`Text()` constructor	Yes	28	?	24	15	8	?
`isElementContentWhitespace`	No	No	?	? — 10	No	No	?
`wholeText`	Yes	?	?	4	Yes	Yes	?
`assignedSlot`	53	53	Yes	Yes	40	10.1	?
`replaceWholeText`	? — 45	? — 45	?	? — 10	? — 32	No	?
`splitText`	Yes Yes Before version 4.4, the `offset` argument was optional.	18 18 Before Chrome 30, the `offset` argument was optional.	?	4	Yes Yes Before Opera 17, the `offset` argument was optional.	Yes Yes The `offset` argument is optional.	?