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

nodeNameプロパティは、Dom\CharacterDataクラスに属するノードの種類を示す名前を保持するプロパティです。PHPのDOM拡張機能では、XMLやHTML文書の各構成要素を「ノード」として扱います。Dom\CharacterDataクラスは、テキスト、コメント、CDATAセクションなど、文字データを直接保持するノードの共通の性質や操作を定義するための抽象クラスです。

このnodeNameプロパティは、当該ノードが具体的にどのような種類の文字データノードであるかを識別するための、一意の文字列を提供します。たとえば、文書内の実際のテキストコンテンツを表すDom\Textノードの場合、このプロパティは常に「#text」という文字列を返します。同様に、XMLやHTMLにおけるコメントを表すDom\Commentノードでは「#comment」を、CDATAセクションを表すDom\CdataSectionノードでは「#cdata-section」という文字列を返します。

このプロパティは読み取り専用であり、ノードが作成される際にその型に応じて自動的に値が設定されるため、プログラムから直接変更することはできません。主に、DOMツリーを走査する際に、現在処理しているノードが特定の種類の文字データノードであるかを確認し、それに応じた処理を実行するために利用されます。ノードの種類を正確に判別するための重要な情報源となります。

Copy
1<?php
2
3$dom = new DOMDocument();
4$textNode = $dom->createTextNode("サンプルテキスト");
5
6// Dom\CharacterData クラスを継承する DOMText オブジェクトの nodeName プロパティにアクセス
7echo $textNode->nodeName;
8
9?>

引数なし

引数はありません

string

このプロパティは、ノードの名前を表す文字列を返します。