MACROMEDIA FLEX-FLEX ACTIONSCRIPT LANGUAGE, Reference

Page: 460 / 830

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");