public firstChild : XMLNode (読み取り専用)

指定された XML オブジェクトを評価し、親ノードの子リスト内の最初の子を参照します。このプロパティは、ノードに子がないときは null です。ノードがテキストノードの場合、このプロパティは undefined です。これは読み取り専用プロパティであり、子ノードを操作する場合には使用できません。子ノードを操作するには、appendChild() メソッド、insertBefore() メソッド、および removeNode() メソッドを使用します。

例

次の例では、XML.firstChild を使用してノードの子ノードをループ処理する方法を示します。

// 新しい XML ドキュメントを作成します。
var doc:XML = new XML();

// ルートノードを作成します
var rootNode:XMLNode = doc.createElement("rootNode");

// 3 つの子ノードを作成します
var oldest:XMLNode = doc.createElement("oldest");
var middle:XMLNode = doc.createElement("middle");
var youngest:XMLNode = doc.createElement("youngest");

// XML ドキュメントツリーのルートとして rootNode を追加します
doc.appendChild(rootNode);

// それぞれの子ノードを rootNode の子として追加します
rootNode.appendChild(oldest);
rootNode.appendChild(middle);
rootNode.appendChild(youngest);

// firstChild を使用して rootNode の子ノードで繰り返し処理を実行します
for (var aNode:XMLNode = rootNode.firstChild; aNode != null; aNode = aNode.nextSibling) {
    trace(aNode);
}

// 出力
// <oldest />
// <middle />
// <youngest />

次の例は、"Examples" ディレクトリの "XML_languagePicker" FLA ファイルから採られています。これは languageXML.onLoad イベントハンドラ関数定義にあります。

// 各言語ノードでストリングをループします
// 各ストリングを新しいエレメントとして言語配列に追加します
for (var stringNode:XMLNode = childNode.firstChild; stringNode != null; stringNode = stringNode.nextSibling, j++) {
    masterArray[i][j] = stringNode.firstChild.nodeValue;
}

スクリプト全体を表示するには、www.adobe.com/go/learn_fl_samples_jp の "ActionScript" サンプルフォルダにある "XML_languagePicker.fla" ファイルを参照してください。.zip ファイルをダウンロードして解凍し、ActionScript バージョンのフォルダに移動してサンプルにアクセスします。

関連項目

appendChild (XMLNode.appendChild メソッド), insertBefore (XMLNode.insertBefore メソッド), removeNode (XMLNode.removeNode メソッド)