User Guide

460 Chapter 6: ActionScript Core Classes
XML.ignoreWhite
Availability
Flash Player 5.
Usage
my_xml.ignoreWhite:boolean
XML.prototype.ignoreWhite:boolean
Parameters
boolean
A Boolean (true or false) value.
Description
Property; default setting is false. When set to true, text nodes that contain only white space are
discarded during the parsing process. Text nodes with leading or trailing white space are
unaffected.
Usage 1: You can set the
ignoreWhite property for individual XML objects, as the following code
shows:
my_xml.ignoreWhite = true;
Usage 2: You can set the default ignoreWhite property for XML objects, as the following code
shows:
XML.prototype.ignoreWhite = true;
Example
The following example loads an XML file with a text node that contains only white space; the
foyer tag comprises fourteen space characters. To run this example, create a text file named
flooring.xml, and copy the following tags into it:
<house>
<kitchen> ceramic tile </kitchen>
<bathroom>linoleum</bathroom>
<foyer> </foyer>
</house>
Create a new Flash document named flooring.fla and save it to the same directory as the XML file.
Place the following code into the main Timeline:
// create a new XML object
var flooring:XML = new XML();
// set the ignoreWhite property to true (default value is false)
flooring.ignoreWhite = true;
// After loading is complete, trace the XML object
flooring.onLoad = function(success:Boolean) {
trace(flooring);
}
// load the XML into the flooring object
flooring.load("flooring.xml");