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

textContentプロパティは、Dom\DocumentFragmentオブジェクトとそのすべての子孫ノードのテキストコンテンツを保持するプロパティです。このプロパティの値を取得すると、フラグメント内に含まれるすべてのノードを再帰的にたどり、それぞれのテキスト部分を連結した一つの文字列が返されます。このとき、HTMLのタグやコメント、処理命令といったマークアップはすべて除去され、純粋なテキスト情報のみが抽出されます。これにより、DOM構造から人間が読むテキスト部分だけを簡単に取り出すことが可能です。逆に、このプロパティに新しい文字列を代入すると、DocumentFragmentが元々保持していたすべての子ノードは完全に削除されます。そして、代入された文字列を内容とする新しいテキストノードが一つだけ、フラグメントの子として新たに追加されます。この機能は、フラグメントの内容を特定のテキストで一括して置き換えたい場合に非常に便利です。

Copy
1<?php
2
3$doc = new Dom\Document();
4$fragment = $doc->createDocumentFragment();
5
6// textContentプロパティに値を設定します
7$fragment->textContent = "Example text content.";
8
9// textContentプロパティの値を取得します
10$text = $fragment->textContent;
11
12echo $text; // "Example text content." を出力
13
14?>

string|null

DomDocumentFragment オブジェクトが保持するテキストノードのコンテンツを文字列として返します。ノードが空の場合は null を返します。