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

wholeTextプロパティは、DOMTextノードが保持するテキスト全体を文字列として取得または設定するためのプロパティです。DOMTextは、XMLやHTMLドキュメント内のテキストを表すノードであり、通常、要素（タグ）間のテキストコンテンツとして存在します。

このプロパティを使用することで、複数の隣接するDOMTextノードが結合されたテキスト全体をまとめて取得できます。例えば、ある要素の中に複数のテキストノードが連続して存在する場合、wholeTextプロパティは、これらのノードの内容を連結した文字列を返します。

テキストノードの内容を書き換えることも可能です。wholeTextプロパティに新しい文字列を代入すると、隣接するすべてのDOMTextノードが削除され、新しいテキスト内容を持つ単一のDOMTextノードに置き換えられます。これにより、ドキュメントの構造を維持しながら、テキストコンテンツを効率的に変更できます。

DOMDocumentオブジェクトを操作する際に、テキストノードの取得や変更を簡単に行うことができるため、XMLやHTMLドキュメントの解析や編集を行うシステムを開発する際に役立ちます。このプロパティを利用することで、テキストノードの扱いが簡略化され、より直感的なコード記述が可能になります。PHPでXMLやHTMLを扱う場合は、DOMTextオブジェクトと合わせて、このwholeTextプロパティの挙動を理解しておくことを推奨します。

Copy
1DOMText::$wholeText;

引数なし

引数はありません

string

DOMTextノードに含まれる全テキストコンテンツを文字列として返します。