splitText

HTML (DHTML)

splitText Method

Internet Development Index

Divides a text node at the specified index.

Syntax

oSplitNode = TextNode.splitText( [iIndex])

Parameters

iIndex Optional. Integer that specifies 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 a text node object.

Remarks

The text node that invokes the splitText method has a nodeValue equal to the substring of the value, from 0 to iIndex . 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.

Example

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.
</UL>

Standards Information

This method is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 Non-Microsoft link.

Applies To

TextNode

See Also

createElement