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

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

作成日: 更新日:

基本的な使い方

textContentプロパティは、Dom\CDATASectionオブジェクトが持つテキストデータを保持するプロパティです。XMLやHTML文書において、CDATAセクションは <& のような特殊文字を解釈させずに、そのままの文字列として扱うために使用される特別な領域(<![CDATA[...]]>)を指します。このtextContentプロパティを利用することで、そのCDATAセクション内に含まれるテキスト全体を一つの文字列として簡単に取得できます。また、このプロパティに新しい文字列を代入することで、CDATAセクションの内容を直接書き換えることも可能です。例えば、XMLデータに含まれるプログラムコードや任意のテキストを動的に変更する際に非常に役立ちます。このプロパティは親クラスであるDom\Nodeから継承されていますが、Dom\CDATASectionにおいては、子ノードを持たないため、ノード自体のテキスト値を直接操作するシンプルで直感的な手段となります。

構文(syntax)

1<?php
2
3$doc = new \Dom\Document();
4$cdata = $doc->createCDATASection("Initial text content");
5
6// textContent プロパティから値を取得します
7$text = $cdata->textContent;
8
9// textContent プロパティに新しい値を設定します
10$cdata->textContent = "Updated text content";
11
12echo $cdata->textContent;
13
14?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

?string

Dom\CDATASection::textContent プロパティは、CDATA セクションのテキストコンテンツを文字列として返します。CDATA セクションが空の場合、または CDATA セクションのテキストコンテンツを処理できない場合は null を返します。

関連コンテンツ