Name
Text.splitText( ) — split a Text node in two
Availability
DOM Level 1 Core
Synopsis
Text splitText(unsigned long offset
)
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
Get JavaScript: The Definitive Guide, Fourth 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.