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

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

作成日: 更新日:

基本的な使い方

nodeValueプロパティは、DOMツリー内のノードが持つテキストコンテンツや属性値などの値を保持するプロパティです。

このプロパティは、PHPのDOM拡張機能におけるDOMDocumentFragmentクラスに属しています。DOMDocumentFragmentは、XMLやHTMLドキュメントのDOM(Document Object Model)ツリーに直接は追加されず、親ノードを持たない軽量な「コンテナ」として機能します。これは、複数のノード(例えば、動的に生成した複数のHTML要素やテキスト)を一時的にまとめて保持し、それらを一度に既存のドキュメントの特定の位置に挿入する際に非常に役立ちます。

しかし、DOMDocumentFragment自体は、テキストコンテンツを直接保持するノードタイプではありません。その役割は、あくまで複数の子ノードを格納する器であるため、自身が固有のテキスト値を持つことはありません。したがって、DOMDocumentFragmentのインスタンスに対してnodeValueプロパティにアクセスしても、常にnullが返されます。これは、このプロパティがそのノードに直接的なテキストデータが存在しないことを示しているためです。もし、DOMDocumentFragment内に含まれる子ノードのテキストコンテンツにアクセスしたい場合は、個々の子ノードに対してアクセスする必要があります。

構文(syntax)

1<?php
2$fragment = new DOMDocumentFragment();
3
4// nodeValueプロパティに値を設定する構文
5$fragment->nodeValue = 'これはDOMDocumentFragmentのnodeValueです。';
6
7// nodeValueプロパティから値を取得する構文
8$value = $fragment->nodeValue;
9
10echo $value;
11?>

引数(parameters)

戻り値(return)

?string

DOMDocumentFragment オブジェクトのノードの値を取得します。ノードの値が存在しない場合は null を返します。

【PHP8.x】nodeValueプロパティの使い方 | いっしー@Webエンジニア