| XML.createTextNode( ) Method | Flash 5 |
| create a new text node |
A string containing the text that is to become the nodeValue of the new node.
A new text node object, with no parent and no children.
The createTextNode( ) method is our primary means of generating new text nodes for inclusion in an XML document object hierarchy. The specified xmlDoc must be the top-level node in an XML object hierarchy (i.e., an instance of the XML class, not the XMLnode class). Note that createTextNode( ) does not insert the element it returns into xmlDoc—we must do that ourselves using appendChild( ) or insertBefore( ). For example, here we create and insert a new P element into a document, and then we give that P element a text-node child:
myDoc = new XML();
newP = myDoc.createElement("P");
myDoc.appendChild(newP);
newText = myDoc.createTextNode("This is the first paragraph");
myDoc.firstChild.appendChild(newText);
trace(myDoc); // Displays: "<P>This is the first paragraph</P>"
Normally, text nodes are stored as the children of element nodes, which are created using createElement( ).
The createTextNode( ) method converts the characters <, >, &, ', and " according to the rules of entity conversion discussed under XML.parseXML( ).
XML.appendChild( ), XML.cloneNode( ), XML.createElement( ), XML.insertBefore( ), XML.parseXML( )
