X-Z > XML (object)

XML (object)

Use the methods and properties of the XML object to load, parse, send, build, and manipulate XML document trees.

You must use the constructor new XML() to create an instance of the XML object before calling any of the methods of the XML object.

XML is supported by Flash 5 or later versions of the Flash Player.


 
Method summary for the XML object
Method Description

appendChild

Appends a node to the end of the specified object's child list.

cloneNode

Clones the specified node and, optionally, recursively clones all children.

createElement

Creates a new XML element.

createTextNode

Creates a new XML text node.

hasChildNodes

Returns true if the specified node has child nodes; otherwise, returns false.

insertBefore

Inserts a node in front of an existing node in the specified node's child list.

load

Loads a document (specified by the XML object) from a URL.

onLoad

A callback function for load and sendAndLoad.

parseXML

Parses an XML document into the specified XML object tree.

removeNode

Removes the specified node from its parent.

send

Sends the specified XML object to a URL.

sendAndLoad

Sends the specified XML object to a URL and loads the server response into another XML object.

toString

Converts the specified node and any children to XML text.



 
Property summary for the XML object
Property Description

docTypeDecl

Sets and returns information about an XML document's DOCTYPE declaration.

firstChild

References the first child in the list for the specified node.

lastChild

References the last child in the list for the specified node.

loaded

Checks if the specified XML object has loaded.

nextSibling

References the next sibling in the parent node's child list.

nodeName

Returns the tag name of an XML element.

nodeType

Returns the type of the specified node (XML element or text node).

nodeValue

Returns the text of the specified node if the node is a text node.

parentNode

References the parent node of the specified node.

previousSibling

References the previous sibling in the parent node's child list.

status

Returns a numeric status code indicating the success or failure of an XML document parsing operation.

xmlDecl

Sets and returns information about an XML document's document declaration.



 
Collections summary for the XML object
Method Description

attributes

Returns an associative array containing all of the attributes of the specified node.

childNodes

Returns an array containing references to the child nodes of the specified node.



 
Constructor for the XML object

Syntax

new XML();
new XML(source);

Arguments

source The XML document parsed to create the new XML object.

Description

Constructor; creates a new XML object. You must use the constructor method to create an instance of the XML object before calling any of the XML object methods.

The first syntax constructs a new, empty XML object.
The second syntax constructs a new XML object by parsing the XML document specified in the source argument, and populates the newly created XML object with the resulting XML document tree.

Note: The createElement and createTextnode methods are the 'constructor' methods for creating the elements and text nodes in an XML document tree.

Player

Flash 5 or later.

Example

The following example creates an new empty XML object:

myXML = new XML();

See also

XML.createTextNode
XML.createElement