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

parentNodeプロパティは、DOMTextオブジェクトの親ノードを保持するプロパティです。PHPのDOMTextクラスは、HTMLやXML文書をプログラムで操作するためのDOM（Document Object Model）拡張機能に属します。DOMTextオブジェクトは、文書内のテキストコンテンツ（例：段落内の文章）を表すノードです。

このparentNodeプロパティは、DOMツリーにおいてそのDOMTextオブジェクトが「どのノードの子であるか」を示します。具体的には、テキストノードが属する親のDOMNodeオブジェクトを返します。例えば、<h1>こんにちは世界</h1>というHTMLの場合、「こんにちは世界」のテキストはDOMTextオブジェクトとなり、そのparentNodeプロパティは親である<h1>要素を表すDOMElementオブジェクトを返します。

もし、特定のDOMTextオブジェクトがまだDOMツリーに組み込まれていない場合や、親を持たない孤立した状態である場合は、このparentNodeプロパティはnullを返します。このプロパティは、文書の階層構造を上方向にたどる際や、特定のテキストの親要素を特定して操作する際に役立ちます。DOMツリーにおける要素間の関係性を把握し、効率的な処理に繋がります。

Copy
1<?php
2$document = new DOMDocument();
3$element = $document->createElement('example_element');
4$document->appendChild($element);
5
6$textNode = $document->createTextNode('Sample text content.');
7$element->appendChild($textNode);
8
9// DOMTextオブジェクトの親ノードを取得する構文
10$parent = $textNode->parentNode;
11
12// 取得した親ノードのノード名を表示して確認
13if ($parent instanceof DOMElement) {
14    echo $parent->nodeName; // 'example_element' と出力される
15}
16?>

引数なし

引数はありません

?DOMNode

DOMTextオブジェクトの親ノードであるDOMNodeオブジェクト、または親ノードが存在しない場合はNULLを返します。