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

parentElementプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

parentElementプロパティは、PHPのDOM拡張機能において、もしDOMDocumentクラスに存在すると仮定した場合、そのオブジェクトの親要素を保持するプロパティです。

DOMDocumentクラスは、XMLやHTMLなどのドキュメント全体を表すルートノードであり、ドキュメントツリーの最上位に位置します。このため、DOMDocumentオブジェクト自身は、構造上、それ以上の親要素を持つことはありません。

一般的に、parentElementプロパティは、DOMElementのような要素ノードに属し、そのノードの直接の親となる要素(DOMElement型)を返します。親ノードがテキストノードやコメントノードである場合、parentElementプロパティはnullを返します。これは、parentElementが親が要素ノードである場合にのみ値を返すという特性があるためです。

したがって、DOMDocumentオブジェクトには論理的な親要素が存在しないため、たとえこのparentElementプロパティがDOMDocumentクラスに実装されていたとしても、その値は常にnullを返すことになります。PHPの公式ドキュメントにおいては、DOMDocumentクラスにparentElementという直接のプロパティは定義されていません。ノードの親を汎用的に参照したい場合は、DOMNodeクラスが提供するparentNodeプロパティが利用されます。

構文(syntax)

1<?php
2$dom = new DOMDocument();
3$parent = $dom->parentElement; // DOMDocumentのparentElementは常にnull
4var_dump($parent);
5?>

引数(parameters)

戻り値(return)

戻り値なし

戻り値はありません