Node: childNodes プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

childNodes は Node インターフェイスの読み取り専用プロパティであり、NodeList で指定された要素の子ノードの生きたリストを返し、最初の子ノードは位置 0 に割り当てられます。子ノードには要素、テキスト、コメントが含まれます。

メモ: NodeList が生きたリストであるというのは、新しい子が追加されたり取り除かれたりするたびに、内容が変化するという意味です。

ノードのコレクションの項目はオブジェクトであり、文字列ではありません。ノードオブジェクトからデータを取得するには、そのプロパティを使用してください。例えば、最初の子ノードの名前を取得するには、 elementNodeReference.childNodes[0].nodeName を使うことで実現できます。

document オブジェクト自体には 2 つの子があります。文書型宣言と、ルート要素、ふつうは documentElement として参照されます。 HTML 文書の場合、後者は <html> 要素です。

覚えておくべき重要なこととして、 childNodes にはすべての子ノードが含まれ、テキストやコメントなどの要素以外のノードが含まれることです。要素のみが含まれるコレクションを取得するのであれば、 Element.children を代わりに使用してください。

// parg は <p> 要素へのオブジェクト参照であることに注意
// まず、要素に子ノードがあるかどうかをチェックします
if (parg.hasChildNodes()) {
 let children = parg.childNodes;
 for (const node of children) {
 // それぞれの子を children[i] として処理します
 // 注: リストは生きています。子を追加したり取り除いたりすると、リストの `length` が変わります
 }
}

ノードからすべての子を削除

// これはあるノードからすべての子を取り除くための一つの方法です
// box はある要素へのオブジェクト参照です
while (box.firstChild) {
 // リストは生きているので、呼び出されるたびにインデックスが変わります
 box.removeChild(box.firstChild);
}