Text : CharacterData

constructor

Text is a Node that represents the text content of the document. The text content of elements like Spans is stored in Text nodes.

Spec

Constructors

new Text([data = '' : String]) : Text

Creates a new Text with the specified data. Can also be created with document.createTextNode().

Example:

<div id='foo'>
  Initial Text.
</div>
<script>
  var extraText = new Text('Extra Text.');
  document.getElementById('foo').appendChild(extraText);
</script>

Run

Results:

Spec

Instance Properties

wholeText : String readonly

Returns a string containing the data of this and data of all adjacent Text siblings of this. Only the data of Texts is joined, wholeText does not walk into other adjacent Node types to pull out the text.

Example:

<div id='foo'>Initial Text. <span>In Span</span></div>
<script>
  var foo = document.getElementById('foo');
  var initialText = foo.firstChild;

  var insertedText = new Text('Inserted Text. ');
  document.getElementById('foo').insertBefore(insertedText, initialText);

  console.log('data: "' + initialText.data + '"');
  console.log('wholeText: "' + initialText.wholeText + '"');
</script>

Run

Results:

Spec

Instance Methods

splitText(offset : Number) : Text

Splits this into 2 Text nodes at the specified offset into data. The first portion of data stays in this and the remainder is placed in a new Text that is returned by the call to splitText(). The remainder Text is inserted after this in this.parentNode.

Example:

<div id='foo'>Initial Text.</div>
<script>
  var foo = document.getElementById('foo');
  var initialText = foo.firstChild;

  console.log('length before split: ' + foo.childNodes.length);

  for (var i = 0; i < foo.childNodes.length; i++) {
    console.log('  ' + i +': "' + foo.childNodes[i].data + '"');
  }
  console.log();

  var remainder = initialText.splitText(3);
  console.log('initialText after split: "' + initialText.data + '"');
  console.log('remainder after split: "' + remainder.data + '"');
  console.log();

  console.log('length after split: ' + foo.childNodes.length);

  for (var i = 0; i < foo.childNodes.length; i++) {
    console.log('  ' + i +': "' + foo.childNodes[i].data + '"');
  }
</script>

Run

Results:

Spec

home license contribute feedback toggle light/dark mode