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
Node.normalize( )
•
Table of Contents
•
Index
•
Reviews
•
Examples
•
Reader Reviews
•
Errata
JavaScript: The Definitive Guide, 4th Edition
By
David Flanagan
Publisher
: O'Reilly
Pub Date
: November 2001
ISBN
: 0-596-00048-0
Pages
: 936
Slots
: 1
This fourth edition of the definitive reference to
JavaScript, a scripting language that can be embedded
directly in web pages, covers the latest version of the
language, JavaScript 1.5, as supported by Netscape 6 and
Internet Explorer 6. The book also provides complete
coverage of the W3C DOM standard (Level 1 and Level 2),
while retaining material on the legacy Level 0 DOM for
backward compatibility.