【PHP8.x】nodeValueプロパティの使い方
nodeValueプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
『nodeValueプロパティは、Dom\Documentオブジェクトが表すドキュメントノード自体の値を保持するプロパティです。しかし、ドキュメントノードはDOMツリー全体のコンテナとしての役割を持ち、特定のテキスト値を持たないという特性があります。そのため、Dom\DocumentオブジェクトのnodeValueプロパティにアクセスした場合、その値は常にnullとなります。このプロパティは、ノードの種類によってその意味が異なり、例えばテキストノードやコメントノードではその内容の文字列を返しますが、ドキュメントノードや要素ノードではnullを返す仕様です。このプロパティに対して値を設定しようとしても、ドキュメントノードには適用されず、その操作は無視されます。したがって、Dom\Documentオブジェクトにおいてこのプロパティを直接利用する場面はほとんどありません。ドキュメントに含まれる全てのテキスト内容を連結して取得したい場合は、textContentプロパティのような別の手段を用いる必要があります。』
構文(syntax)
1<?php 2 3$document = new Dom\Document(); 4 5$value = $document->nodeValue; 6 7var_dump($value); 8 9?>
引数(parameters)
戻り値(return)
string|null
Dom\Document::nodeValue プロパティは、ノードのテキストコンテンツを表す文字列、またはノードにテキストコンテンツがない場合は null を返します。