【PHP8.x】parentNodeプロパティの使い方

parentNodeプロパティは、Dom\Commentオブジェクトが属する親ノードを保持するプロパティです。Dom\Commentクラスは、HTMLやXMLドキュメント内で「<!-- ... -->」形式のコメントを表します。このプロパティは、特定のコメントノードがドキュメントのどこに位置し、どのノードの直接の子であるかを知りたいときに利用されます。

WebページやXMLデータの構造は、ツリー状の親子関係で構成されており、すべてのノードは何らかの親ノードを持つのが一般的です。例えば、あるHTML要素の中に記述されたコメントノードがあった場合、そのコメントノードのparentNodeプロパティは、そのHTML要素を表すDom\Elementオブジェクトを返します。コメントがドキュメント自体の直下にあるような稀なケースでは、Dom\Documentオブジェクトを返すこともあります。

もし、コメントノードがまだドキュメントツリーに挿入されていない、またはツリーから削除されているなど、親ノードが存在しない状態である場合、このparentNodeプロパティはnullを返します。

このプロパティはDom\Node型を返すため、取得した親ノードに対してさらにその親をたどったり、子ノードの一覧を取得したりと、DOMツリー内を自由に移動し、操作するための起点として活用できます。システムエンジニアを目指す方にとって、DOM構造の理解と操作はウェブアプリケーション開発の基礎であり、parentNodeプロパティはその基本的ながら非常に重要な側面を担っています。

Copy
1<?php
2
3$document = new Dom\Document();
4$element = $document->createElement('example');
5$document->appendChild($element);
6
7$comment = $document->createComment('これはコメントです。');
8$element->appendChild($comment);
9
10// Dom\Comment::parentNode プロパティにアクセスして親ノードを取得します。
11$parentNode = $comment->parentNode;
12
13// $parentNode には、$comment の親ノードである Dom\Element のインスタンスが格納されます。

引数なし

引数はありません

?Dom\Node

parentNode プロパティは、このコメントノードが属する親ノードを Dom\Node オブジェクトまたは null として返します。親ノードが存在しない場合は null が返されます。