ignoreWhite (XML.ignoreWhite プロパティ)

デフォルト設定は false です。true を設定すると、空白のみを含むテキストノードは解析処理中に破棄されます。先行空白または後続空白があるテキストノードは影響を受けません。

シンタックス 1: 次のコードに示すように、XML オブジェクトごとに ignoreWhite プロパティを設定できます。

my_xml.ignoreWhite = true;

シンタックス 2: 次のコードに示すように、XML オブジェクトにデフォルトの ignoreWhite プロパティを設定できます。

XML.prototype.ignoreWhite = true;

例

次の例では、空白のみのテキストノードが含まれる XML ファイルをロードします。foyer タグは 14 個の空白文字で構成されます。この例を実行するには、"flooring.xml " という名前のテキストファイルを作成し、そのファイルに次のタグをコピーします。

 <house>
 <kitchen> ceramic tile </kitchen>
 <bathroom>linoleum</bathroom>
 <foyer> </foyer>
 </house>

"flooring.fla" という名前で新しい Flash ドキュメントを作成し、それを XML ファイルと同じディレクトリに保存します。次のコードをメインタイムラインに配置します。

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

// Output (line breaks added for clarity):
<house>
    <kitchen> ceramic tile </kitchen>
    <bathroom>linoleum</bathroom>
    <foyer />
</house>

flooring.ignoreWhite の設定を false に変更するか、単純に flooring.ignoreWhite が含まれるコード行を削除する場合、foyer タグの 14 個の空白文字は削除されません。

...
// Set the ignoreWhite property to false (default value).
flooring.ignoreWhite = false;
...
// Output (line breaks added for clarity):
<house>
    <kitchen> ceramic tile </kitchen>
    <bathroom>linoleum</bathroom>
    <foyer> </foyer>
</house>

他の例については、Flash サンプルページ (www.adobe.com/go/learn_fl_samples_jp) を参照してください。"Samples" zip ファイルをダウンロードし解凍して、"ActionScript2.0\XML_BlogTracker" フォルダに移動して XML_blogTracker.fla ファイルにアクセスし、"ActionScript2.0\XML_LanguagePicker" フォルダに移動して XML_languagePicker.fla ファイルにアクセスします。