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 July 2015.
childNodes は Node インターフェイスの読み取り専用プロパティであり、NodeList で指定された要素の子ノードの生きたリストを返し、最初の子ノードは位置 0 に割り当てられます。子ノードには要素、テキスト、コメントが含まれます。
メモ: NodeList が生きたリストであるというのは、新しい子が追加されたり取り除かれたりするたびに、内容が変化するという意味です。
ノードのコレクションの項目はオブジェクトであり、文字列ではありません。ノードオブジェクトからデータを取得するには、そのプロパティを使用してください。例えば、最初の子ノードの名前を取得するには、 elementNodeReference.childNodes[0].nodeName を使うことで実現できます。
document オブジェクト自体には 2 つの子があります。文書型宣言と、ルート要素、ふつうは documentElement として参照されます。 HTML 文書の場合、後者は <html> 要素です。
覚えておくべき重要なこととして、 childNodes にはすべての子ノードが含まれ、テキストやコメントなどの要素以外のノードが含まれることです。
要素のみが含まれるコレクションを取得するのであれば、 Element.children を代わりに使用してください。
値
例
単純な使用方法
js
// parg は <p> 要素へのオブジェクト参照であることに注意
// まず、要素に子ノードがあるかどうかをチェックします
if (parg.hasChildNodes()) {
let children = parg.childNodes;
for (const node of children) {
// それぞれの子を children[i] として処理します
// 注: リストは生きています。子を追加したり取り除いたりすると、リストの `length` が変わります
}
}
ノードからすべての子を削除
js
// これはあるノードからすべての子を取り除くための一つの方法です
// box はある要素へのオブジェクト参照です
while (box.firstChild) {
// リストは生きているので、呼び出されるたびにインデックスが変わります
box.removeChild(box.firstChild);
}
仕様書
| Specification |
|---|
| DOM # ref-for-dom-node-childnodes① |