ActionScript for Flash MX: The Definitive Guide, Second Edition

XML.createTextNode() Method

This is the Title of the Book, eMatter Edition

Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.

Alphabetical Language Reference

|

925

XML.createElement() Method

create a new element node

Flash 5

xmlDoc.createElement(tagName)

Arguments

tagName A case-sensitive string indicating the name of the element to create. For

example, in the tag,

<P ALIGN="RIGHT">, P is the tag name.

Returns

A new element node object, with no parent and no children.

Description

The createElement() method is our primary means of generating new element 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 createElement() 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:

myDoc = new XML();

newP = myDoc.createElement("P");

myDoc.appendChild(newP);

We can combine those steps by using this:

myDoc.appendChild(myDoc.createElement("P"));

The createElement() method cannot be used to create text nodes; use createTextNode()

instead.

See Also

XML.appendChild(), XML.cloneNode(), XML.createTextNode(), XML.insertBefore()

XML.createTextNode() Method

create a new text node

Flash 5

xmlDoc.createTextNode(text)

Arguments

text A string containing ...