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

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

作成日: 更新日:

基本的な使い方

textContentプロパティは、Dom\Elementオブジェクトが持つ、HTMLドキュメント内の要素とそのすべての子孫ノードのテキストコンテンツを保持するプロパティです。このプロパティを使用すると、指定されたHTML要素(例えば、Webページの<p>タグや<div>タグなど)が含む純粋なテキスト情報を取得したり、そのテキスト内容を新しく設定したりできます。

具体的には、あるHTML要素が持つ開始タグから終了タグまでの間に含まれるテキストすべてを、HTMLタグや属性を無視して抽出します。例えば、<p>こんにちは、<b>世界</b>!</p>というHTML構造を持つ要素に対してこのプロパティを取得した場合、「こんにちは、世界!」という文字列が得られます。逆に、このプロパティに新しい文字列を代入することで、その要素内のテキスト内容を簡単に更新することが可能です。

この機能は、Webスクレイピングで特定の情報(ニュース記事の本文や商品の説明文など)からタグを除いたテキストだけを抽出したい場合や、PHPスクリプトで動的にWebページを生成する際に、HTMLタグを含まないプレーンテキストを要素内に安全に挿入したい場合に非常に役立ちます。HTMLタグをそのまま扱ってしまうような他のプロパティと異なり、textContentは純粋なテキストのみを対象とするため、意図しないHTMLの解釈やスクリプトの実行といったセキュリティ上の問題を避ける効果も期待できます。

したがって、PHPを使ってHTMLドキュメントの構造を操作し、要素のテキスト内容を効率的かつ安全に管理するための基本的ながら強力な手段として利用されます。

構文(syntax)

1<?php
2use Dom\Document;
3
4$document = new Document();
5$element = $document->createElement('p');
6$element->textContent = '要素のテキストコンテンツを設定します。';
7echo $element->textContent; // 設定されたテキストコンテンツを取得し、表示します。
8?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

Dom\Element クラスの textContent プロパティは、その要素内に含まれるすべてのテキストコンテンツを結合した文字列を返します。

関連コンテンツ

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