User Guide

XML 1291

createElement (XML.createElement method)

public createElement(name:String) : XMLNode

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>