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

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

作成日: 2025年09月11日更新日: 2025年11月06日

基本的な使い方

nodeNameプロパティは、DOM（Document Object Model）のHTMLDocumentオブジェクトにおけるノードの名前を保持するプロパティです。具体的には、このプロパティは常に "#document" という文字列を返します。HTMLDocumentオブジェクトは、HTMLドキュメント全体を表すノードであり、その名前は常に固定されているためです。

システムエンジニアを目指す初心者の方にとって、このプロパティの理解はDOM構造の把握に役立ちます。DOMは、HTMLやXMLドキュメントをツリー構造で表現し、JavaScriptなどのスクリプト言語からアクセスして操作できるようにする仕組みです。HTMLDocumentオブジェクトは、そのDOMツリーのルートノードにあたり、nodeNameプロパティを通じて、それがドキュメントノードであることを識別できます。

nodeNameプロパティは、他の種類のDOMノード（例えば、要素ノードやテキストノード）でも利用できます。しかし、HTMLDocumentオブジェクトにおいては、その値は常に "#document" であるという点が重要です。これは、ドキュメントノードの種類を特定し、他のノードとの区別を明確にするために役立ちます。

このプロパティの利用例としては、特定のノードがドキュメントノードであるかどうかをプログラム内で判定する際に使用できます。例えば、DOMツリーを走査中に、特定のノードのnodeNameプロパティを調べ、"#document" であればドキュメントノードとして特別な処理を行うといった実装が考えられます。

構文(syntax)


1<?php
2$dom = new DomDocument();
3$dom->loadHTML('<html><body><p id="test">Hello</p></body></html>');
4$element = $dom->getElementById('test');
5echo $element->nodeName; // "p"
6?>

引数(parameters)

戻り値(return)

string

Dom\HTMLDocument クラスの nodeName プロパティは、ノードの名前を表す文字列を返します。