Name
Text.splitText( ): split a Text node in two — DOM Level 1 Core
Synopsis
Text splitText(unsigned longoffset)
throws DOMException;Arguments
-
offset The character position at which to split the Text node.
Returns
The Text node that was split from this node.
Throws
This method may throw a DOMException with one of the
following code values:
-
INDEX_SIZE_ERR offsetis negative or greater than the length of the Text or Comment node.-
NO_MODIFICATION_ALLOWED_ERR The node is read-only and may not be modified.
Description
This method splits a Text node in two at the specified
offset. The original Text node is
modified so that it contains all text content up to, but not
including, the character at position
offset. A new Text node is created to
contain all the characters from (and including) the position
offset to the end of the string. This new
Text node is the return value of the method. Additionally, if the
original Text node has a parentNode, the new node is inserted into
this parent node immediately after the original node.
The CDATASection interface inherits from Text, and this
splitText( ) method can also be
used with CDATASection nodes, in which case the newly created node
is a CDATASection rather than a Text node.
See Also
Node.normalize( )
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access