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

nodeValueプロパティは、Dom\Elementクラスに属し、HTMLやXMLドキュメント内の要素のテキストコンテンツを保持するプロパティです。Dom\Elementクラスは、HTMLにおける<p>タグや<div>タグのように、タグで囲まれた一つのまとまりである「要素ノード」を表します。

このnodeValueプロパティを利用すると、対象となる要素ノードに含まれるすべてのテキスト情報を、子要素のタグ構造を考慮せずに、単一の連結された文字列として読み取ることが可能です。例えば、ある<div>タグの中に複数の子要素やテキストが混在していても、その<div>タグのnodeValueプロパティを参照すれば、その<div>タグ内に存在する純粋なテキスト部分だけをまとめて取得できます。

また、このプロパティに新しい文字列を設定することで、要素ノード内の既存のテキストコンテンツを置き換えることもできます。これにより、プログラムから動的にウェブページのテキストを変更したり、XMLデータの文字列内容を操作したりする際に非常に強力な機能となります。システムエンジニアとしてDOM（Document Object Model）を操作する際には、要素の内部テキストを効率的に取得したり設定したりするための基本的な機能として、このnodeValueプロパティは頻繁に活用されます。

Copy
1<?php
2$document = new Dom\Document();
3$element = $document->createElement('tag', 'テキスト内容');
4echo $element->nodeValue;
5?>

引数なし

引数はありません

string|null

この nodeValue プロパティは、XMLまたはHTMLドキュメントのノードのテキストコンテンツを返します。ノードがテキストノードでない場合や、テキストコンテンツが存在しない場合は null を返します。