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
offset
is 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( )
Get JavaScript: The Definitive Guide, 5th Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.