User Guide

1316 ActionScript classes
appendChild (XMLNode.appendChild method)
public appendChild(newChild:XMLNode) : Void
Appends the specified node to the XML object's child list. This method operates directly on
the node referenced by the
childNode parameter; it does not append a copy of the node. If
the node to be appended already exists in another tree structure, appending the node to the
new location will remove it from its current location. If the
childNode parameter refers to a
node that already exists in another XML tree structure, the appended child node is placed in
the new tree structure after it is removed from its existing parent node.
Availability: ActionScript 1.0; Flash Player 5
Parameters
newChild:XMLNode - An XMLNode that represents the node to be moved from its current
location to the child list of the
my_xml object.
Example
This example does the following things in the order shown:
■ Creates two empty XML documents, doc1 and doc2.
■ Creates a new node using the createElement() method, and appends it, using the
appendChild() method, to the XML document named doc1.
■ Shows how to move a node using the appendChild() method, by moving the root node
from
doc1 to doc2.
■ Clones the root node from doc2 and appends it to doc1.
■ Creates a new node and appends it to the root node of the XML document doc1.
var doc1:XML = new XML();
var doc2:XML = new XML();
// create a root node and add it to doc1
var rootnode:XMLNode = doc1.createElement("root");
doc1.appendChild(rootnode);
trace ("doc1: " + doc1); // output: doc1: <root />
trace ("doc2: " + doc2); // output: doc2:
// move the root node to doc2
doc2.appendChild(rootnode);
trace ("doc1: " + doc1); // output: doc1:
trace ("doc2: " + doc2); // output: doc2: <root />
// clone the root node and append it to doc1
var clone:XMLNode = doc2.firstChild.cloneNode(true);
doc1.appendChild(clone);
trace ("doc1: " + doc1); // output: doc1: <root />