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

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

作成日: 更新日:

基本的な使い方

DOMTextクラスのpreviousElementSiblingプロパティは、現在のテキストノードの直前の兄弟要素ノードを返します。DOM(Document Object Model)において、ノードはXMLやHTMLドキュメントの構成要素であり、要素、属性、テキストなど様々な種類が存在します。このプロパティは、DOMTextノード(テキストノード)の兄弟関係にある要素ノードを取得するために使用されます。

具体的には、DOMTextノードがDOMツリー内に存在し、その直前に要素ノードが存在する場合、previousElementSiblingプロパティはその要素ノードを返します。もし直前の兄弟ノードが要素ノードでなければ(例えば、テキストノードやコメントノードの場合)、あるいは直前の兄弟ノードが存在しない場合は、nullを返します。

このプロパティは読み取り専用であり、値を設定することはできません。主に、DOMツリーをナビゲートし、特定のテキストノードに関連する要素ノードを効率的に取得するために利用されます。例えば、あるテキストノードの直前の要素ノードの属性値を調べたり、その要素ノードに対して何らかの処理を行いたい場合に役立ちます。DOM操作において、ノード間の関係性を把握し、特定のノードを基準に他のノードにアクセスする際に重要な役割を果たします。特に、動的に生成されたDOMツリーや、複雑な構造を持つドキュメントを扱う場合に、previousElementSiblingプロパティは有効な手段となります。

構文(syntax)

1DOMText::$previousElementSibling;

引数(parameters)

引数なし

引数はありません

戻り値(return)

DOMElement|null

previousElementSibling プロパティは、この DOMText ノードの直前の兄弟要素ノードを返します。直前の兄弟ノードが存在しない場合は null を返します。

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