Flash CS3 Documentation

ActionScript 2.0 Language Reference > ActionScript classes > XML > createElement (XML.createElement method)

createElement (XML.createElement method)

Creates a new XML element with the name specified in the parameter. The new element initially has no parent, no children, and no siblings. The method returns a reference to the newly created XML object that represents the element. This method and the XML.createTextNode() method are the constructor methods for creating nodes for an XML object.

Availability: ActionScript 1.0; Flash Player 5

Parameters

name:String - The tag name of the XML element being created.

Returns

XMLNode - An XMLNode object; an XML element.

Example

The following example creates three XML nodes using the createElement() method:

// create an XML document
var doc:XML = new XML();

// create three XML nodes using createElement()
var element1:XMLNode = doc.createElement("element1");
var element2:XMLNode = doc.createElement("element2");
var element3:XMLNode = doc.createElement("element3");

// place the new nodes into the XML tree
doc.appendChild(element1);
element1.appendChild(element2);
element1.appendChild(element3);

trace(doc);
// output: <element1><element2 /><element3 /></element1>

See also

createTextNode (XML.createTextNode method)

Flash CS3