splitText

Summary

Divides a text node at the specified index.

Method of dom/Textdom/Text

Syntax

var textNode = textNode.splitText(/* see parameter list */);

Parameters

offset

Data-type

String

The index of the string that indicates where the separation occurs. If a value is not provided, a new text node with no value is created.

Return Value

Returns an object of type DOM NodeDOM Node

A text node object.

Examples

This example uses the splitText method to divide a text node in half in a ul object. When the text node splits, the createElement method creates a new li object. The appendChild method appends the new li element and the split text node to the ul object.

<script>
function fnSplitNode(){
   var oNode=oList.firstChild.childNodes(0);
   var oNewNode=document.createElement("LI");
   var oSplitNode = oNode.splitText(oNode.nodeValue.length/2);
   oList.appendChild(oNewNode);
   oNewNode.appendChild(oSplitNode);
}
</script>
<ul onclick="fnSplitNode()" id="oList">
<li>This is a list item.</li>
</ul>

Notes

The text node that invokes the splitText method has a nodeValue equal to the substring of the value, from zero to offset. The new text node has a nodeValue of the substring of the original value, from the specified index to the value length. Text node integrity is not preserved when the document is saved or persisted.

Related specifications

DOM Level 3 Core

Recommendation

Attributions

• Mozilla Developer Network : [Text.splitText Article]

• Microsoft Developer Network: [splitText Method Article]