【PHP8.x】dataプロパティの使い方
dataプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
dataプロパティは、Dom\Textオブジェクトが表すテキストノードの実際の文字列データを保持するプロパティです。このプロパティは、親クラスであるDom\CharacterDataから継承されており、HTMLやXMLドキュメント内の具体的なテキスト内容に直接アクセスするために使用されます。例えば、<p>サンプルテキスト</p>というHTML要素がある場合、p要素の子であるテキストノードのdataプロパティには、「サンプルテキスト」という文字列が格納されています。このプロパティは値の読み取りだけでなく、新しい文字列を代入することによる書き込みも可能です。これにより、DOMツリー内のテキストを動的に変更できます。Dom\Nodeクラスから継承されるtextContentプロパティと機能が似ていますが、Dom\TextノードにおいてはdataとtextContentは同じ値を返します。textContentが子孫ノード全体のテキストを連結して返すのに対し、dataはそのノード自身が持つ純粋なテキストデータのみを扱う点が特徴です。したがって、個別のテキストノードの値を正確に操作する際に不可欠なプロパティとなります。
構文(syntax)
1<?php 2 3$document = new \Dom\Document(); 4$document->loadHTML('<div>Sample Text</div>'); 5 6$textNode = $document->getElementsByTagName('div')[0]->firstChild; 7 8// Dom\Text::data プロパティから値を取得します 9echo $textNode->data . PHP_EOL; 10 11// Dom\Text::data プロパティに新しい値を設定します 12$textNode->data = 'New Text Content'; 13 14echo $document->saveHTML(); 15 16?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
string
Dom\Text クラスの data プロパティは、ノードのテキストコンテンツを文字列として返します。