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

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

作成日: 更新日:

基本的な使い方

nodeValueプロパティは、DOMツリーにおける各ノードが持つテキスト値を取得または設定するために設計されたプロパティです。しかし、このプロパティが所属するDOM\XMLDocumentクラスのオブジェクトは、XMLドキュメント全体のルートノードを表します。ドキュメントノード自体は、HTMLの要素やテキスト、コメントのように具体的なテキストコンテンツを直接保持しません。

そのため、DOM\XMLDocumentオブジェクトのnodeValueプロパティにアクセスした場合、常にnullが返されます。このプロパティに何らかの文字列値を設定しようとしても、ドキュメントオブジェクトの構造や内容には実際の影響を与えません。

nodeValueプロパティが有効に機能するのは、DOM\Text(テキストノード)、DOM\Attr(属性ノード)、DOM\Comment(コメントノード)などのように、直接的にテキストデータを保持するノードタイプに対してです。これらのノードでは、nodeValueプロパティを通じてその内容を読み取ったり、変更したりすることができます。DOM\XMLDocumentオブジェクトでコンテンツを操作する際は、代わりにdocumentElementプロパティを通じてルート要素にアクセスし、その子ノードや属性を操作することになります。

構文(syntax)

1<?php
2
3$document = new Dom\XMLDocument();
4$nodeValue = $document->nodeValue;

引数(parameters)

引数なし

引数はありません

戻り値(return)

string|null

このプロパティは、XMLノードのテキストコンテンツを文字列として返します。ノードにテキストコンテンツがない場合はnullを返します。

関連コンテンツ