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

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

作成日: 更新日:

基本的な使い方

『parentElementプロパティは、現在の処理命令(Dom\ProcessingInstruction)ノードの親要素を保持するプロパティです。このプロパティは読み取り専用であり、DOMツリー構造の中で、この処理命令ノードがどの要素ノード(Dom\Element)の直接の子であるかを取得するために使用されます。もし親ノードが要素である場合、その親要素を表すDom\Elementオブジェクトを返します。一方で、親ノードが存在しない場合や、親ノードが要素ではない場合(例えば、ドキュメントオブジェクトの直下にある場合など)にはnullを返します。類似のparentNodeプロパティは、親ノードの種類を問わずにノードオブジェクトを返しますが、parentElementは親が要素である場合に限定されるという違いがあります。この特性により、処理命令の親が特定のタグ要素であることを前提とした操作を行う際に、型を厳密にチェックしながら安全にコードを記述するのに役立ちます。

構文(syntax)

1<?php
2
3$document = new \Dom\Document();
4$document->loadXML(<<<XML
5<?xml version="1.0" encoding="utf-8"?>
6<book>
7  <?php-stylesheet type="text/css" href="style.css"?>
8  <title>PHP Manual</title>
9</book>
10XML);
11
12$xpath = new \Dom\XPath($document);
13
14// 処理命令ノードを取得します
15$pi_node = $xpath->query('//processing-instruction()')[0];
16
17// Dom\ProcessingInstruction オブジェクトの parentElement プロパティにアクセスします
18$parentElement = $pi_node->parentElement;
19
20// 親要素のタグ名を出力します
21echo $parentElement->tagName; // "book"
22
23?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

Dom\Element|null

このプロパティは、この処理命令ノードが属する親要素ノードを返します。親要素が存在しない場合は null を返します。

関連コンテンツ

関連プログラミング言語