【PHP8.x】textContentプロパティの使い方
textContentプロパティの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
textContentプロパティは、DOMDocumentオブジェクトのテキストコンテンツ全体を取得または設定するために使用されるプロパティです。このプロパティは、ドキュメント内のすべてのテキストノードを連結した文字列を返します。
取得時には、ドキュメント内のテキストノードを探索し、それらのテキストノードの値を連結して返します。これにより、HTMLドキュメントやXMLドキュメントから、要素のタグを除いたテキスト部分のみを効率的に抽出することができます。空白文字や改行もテキストノードの一部として含まれるため、必要に応じてトリミングや置換などの処理を行うことが推奨されます。
設定時には、ドキュメント内の既存の子ノードをすべて削除し、指定されたテキストコンテンツを持つ新しいテキストノードをドキュメントのルートノードの子ノードとして追加します。この操作によって、ドキュメントの内容が完全に置き換えられるため、注意が必要です。例えば、HTMLドキュメントにテキストを設定すると、<p>タグなどの構造は失われ、設定されたテキストのみが残ります。
textContentプロパティは、DOMDocumentオブジェクトが表すドキュメント全体のテキストコンテンツを操作するための便利な手段を提供します。ドキュメントからテキスト情報を抽出したり、ドキュメントの内容をテキストで置き換えたりする際に活用できます。ただし、ドキュメントの構造を維持する必要がある場合は、他のDOM操作メソッドと組み合わせて使用するなど、適切な処理を検討する必要があります。
構文(syntax)
1DOMDocument::$textContent;
引数(parameters)
戻り値(return)
string
DOMDocumentオブジェクトが表すノードとそのすべての子孫ノードのテキストコンテンツを結合した文字列を返します。