【PHP8.x】DOMCharacterData::nextElementSiblingプロパティの使い方

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

作成日: 2025年09月11日更新日: 2025年11月11日

基本的な使い方

nextElementSiblingプロパティは、DOM（Document Object Model）ツリー上で、現在のDOMCharacterDataノードの直後に存在する次の要素ノードを保持するプロパティです。

DOMCharacterDataノードとは、HTMLやXML文書内のテキストデータやコメントデータなどを表すノードの一種です。このプロパティは、現在のDOMCharacterDataノードと同じ階層（兄弟関係）にあるノードの中から、次に現れる要素ノード（例えば、や<div>といったHTMLタグで表現されるもの）を取得するために使用されます。

具体的には、現在のノードの直後にテキストノードやコメントノードといった非要素ノードが存在する場合でも、それらをスキップし、次に発見される最初の要素ノードを返します。

もし、現在のノードの直後に要素ノードが存在しない場合や、現在のノードがその親ノードの最後の兄弟ノードである場合には、このプロパティはnullを返します。

このプロパティを活用することで、PHPプログラムからDOMツリー内を効率的に移動し、目的の要素を検索したり、要素間の関連性を把握して文書構造を操作したりすることが可能になります。

構文(syntax)


1<?php
2$dom = new DOMDocument();
3$textNode = $dom->createTextNode('Hello');
4$nextElement = $textNode->nextElementSibling;

引数(parameters)

引数なし

引数はありません

戻り値(return)

?DOMElement

DOMCharacterDataノードの次にある兄弟要素ノードを返します。要素ノードが見つからない場合はnullを返します。

サンプルコード

PHP DOMCharacterData::nextElementSibling で次の兄弟要素を取得する


1<?php
2
3/**
4 * DOMCharacterData::nextElementSibling プロパティの使用例を示します。
5 *
6 * このプロパティは、DOMツリー内で、現在のノードの次の兄弟要素ノードを返します。
7 * 例えば、テキストノードの直後に要素ノードがある場合、それを取得できます。
8 * 次の兄弟ノードが要素でない場合（例: コメントノード、別のテキストノード、またはノードが存在しない場合）は null を返します。
9 */
10function demonstrateDomNextElementSibling(): void
11{
12    // 解析するHTML文字列を定義します。
13    // 「これはテキストノードです。」の次にくる要素は <span> タグです。
14    $html = <<<HTML
15    <div id="container">
16        <!-- これはコメントノードです -->
17        <p>最初の段落です。</p>
18        これはテキストノードです。
19        <span>次の要素です。</span>
20        <p>最後の段落です。</p>
21    </div>
22    HTML;
23
24    // DOMDocument オブジェクトを初期化します。
25    $dom = new DOMDocument();
26    // HTML文字列をDOMDocumentにロードします。
27    // LIBXML_HTML_NOIMPLIED と LIBXML_HTML_NODEFDTD は、
28    // 自動的に <html> や <body> タグが追加されるのを防ぎ、シンプルなDOMツリーを構築します。
29    // @ を付けてエラー抑制するのは、不完全なHTMLでも警告が出ないようにするためです。
30    @$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
31
32    // idが "container" の要素を取得します。
33    $container = $dom->getElementById('container');
34
35    if (!$container) {
36        echo "エラー: 'container' 要素が見つかりません。\n";
37        return;
38    }
39
40    $targetTextNode = null;
41    // コンテナ要素の子ノードをループして、目的のテキストノードを探します。
42    foreach ($container->childNodes as $node) {
43        // ノードが DOMText のインスタンスであり、特定のテキスト内容を持つか確認します。
44        // DOMText は DOMCharacterData を継承しています。
45        if ($node instanceof DOMText && trim($node->nodeValue) === 'これはテキストノードです。') {
46            $targetTextNode = $node;
47            break;
48        }
49    }
50
51    if ($targetTextNode) {
52        echo "ターゲットのテキストノードが見つかりました: \"" . trim($targetTextNode->nodeValue) . "\"\n";
53
54        // nextElementSibling プロパティを使用して、現在のテキストノードの次の兄弟要素を取得します。
55        // このプロパティは DOMElement オブジェクトか、見つからない場合は null を返します。
56        $nextElement = $targetTextNode->nextElementSibling;
57
58        if ($nextElement instanceof DOMElement) {
59            echo "--- 次の兄弟要素が見つかりました ---\n";
60            echo "タグ名: " . $nextElement->tagName . "\n";
61            echo "ノードの内容: " . trim($nextElement->textContent) . "\n";
62            // 取得した要素のHTMLスニペットを出力します。
63            echo "HTMLスニペット: " . $dom->saveHTML($nextElement) . "\n";
64        } else {
65            echo "次の兄弟要素は見つかりませんでした。\n";
66            echo "(次のノードは要素ではないか、ノードが存在しません。)\n";
67        }
68    } else {
69        echo "エラー: ターゲットのテキストノード \"これはテキストノードです。\" が見つかりませんでした。\n";
70    }
71}
72
73// 関数を実行します。
74demonstrateDomNextElementSibling();
75

DOMCharacterData::nextElementSibling プロパティは、Webページの構造を表すDOM（Document Object Model）ツリーにおいて、現在のノードの次に位置する兄弟要素ノードを取得するために使用されます。ここで言う「兄弟ノード」とは、親が同じで隣り合っているノードのことを指し、「要素ノード」とはやなどのHTMLタグで囲まれた部分を意味します。

このプロパティには引数は必要ありません。戻り値は、もし次の兄弟ノードが要素であればDOMElementオブジェクトを返します。しかし、次の兄弟ノードがテキストノードやコメントノードのような要素ではない場合、あるいは次の兄弟ノード自体が存在しない場合はnullを返します。

サンプルコードでは、まずHTML文字列をPHPのDOMDocumentクラスで解析し、DOMツリーを構築します。次に、特定のテキストノード（DOMCharacterDataを継承するDOMTextのインスタンス）を見つけ出し、そのノードに対してnextElementSiblingプロパティを適用しています。これにより、テキストノードの直後に位置する要素ノードを正確に取得し、そのタグ名や内容、HTMLスニペットを表示することで、プロパティの挙動を具体的に示しています。この機能は、DOMツリー内で特定の要素に隣接する要素を効率的に見つける際に非常に役立ちます。

nextElementSiblingプロパティは、現在のノードの次の兄弟ノードのうち、DOM要素ノードだけを対象とします。テキストノードやコメントノードはスキップされ、次の兄弟ノードが要素でない場合はnullを返します。そのため、取得した結果は必ずif ($nextElement instanceof DOMElement)のように型を確認し、nullでないことを保証してから利用してください。これにより、予期せぬエラーを防ぐことができます。HTMLは要素だけでなく、テキストやコメントも独立したノードとして扱われるため、この違いを理解することが重要です。また、loadHTML関数での@によるエラー抑制は、本番環境では避け、適切にエラーを処理するよう心がけましょう。

PHP DOMCharacterData::nextElementSiblingで次の兄弟要素を取得する


1<?php
2
3/**
4 * DOMCharacterData::nextElementSibling の使用例を示す関数です。
5 *
6 * このプロパティは、現在のノードの次にある最も近い兄弟要素 (DOMElement) を返します。
7 * 次の兄弟がテキストノードやコメントノードの場合、それらはスキップされます。
8 * 兄弟要素が見つからない場合は null を返します。
9 *
10 * @link https://www.php.net/manual/ja/class.domcharacterdata.php#domcharacterdata.props.nextelementsibling
11 */
12function showNextElementSiblingExample(): void
13{
14    // サンプルとして使用するHTML構造を定義します。
15    // いくつかのテキストノード、コメントノード、要素ノードを含めます。
16    $html = <<<HTML
17<div id="container">
18    <p>最初の段落。</p>
19    <!-- これはコメントです -->
20    もう一つのテキストです。
21    <span>これはスパン要素です。</span>
22    最後のテキストです。
23</div>
24HTML;
25
26    // DOMDocument オブジェクトを作成し、HTMLをロードします。
27    // HTMLの自動補完やエラー警告を抑制するためのオプションを指定します。
28    $dom = new DOMDocument();
29    @$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD | LIBXML_NOWARNING);
30
31    // XPath を使用して、特定のテキストノードを見つけます。
32    // 「もう一つのテキストです。」というDOMTextノードを探します。
33    $xpath = new DOMXPath($dom);
34    $queryTextNode = "//div[@id='container']/text()[normalize-space(.)='もう一つのテキストです。']";
35    $targetTextNodeList = $xpath->query($queryTextNode);
36
37    if ($targetTextNodeList->length > 0) {
38        /** @var DOMText $targetTextNode DOMCharacterData を継承する DOMText ノード */
39        $targetTextNode = $targetTextNodeList->item(0);
40
41        echo "--- DOMText ノードの nextElementSibling の例 ---\n";
42        echo "ターゲットノード (DOMText) のデータ: '{$targetTextNode->data}'\n";
43
44        // nextElementSibling プロパティを使用して、次の兄弟要素ノードを取得します。
45        // 「もう一つのテキストです。」の次にある <span> 要素が取得されます。
46        $nextElementFromText = $targetTextNode->nextElementSibling;
47
48        if ($nextElementFromText instanceof DOMElement) {
49            echo "見つかった次の兄弟要素:\n";
50            echo "  タグ名: {$nextElementFromText->tagName}\n";
51            echo "  コンテンツ: '{$nextElementFromText->textContent}'\n";
52        } else {
53            echo "ターゲットノード '{$targetTextNode->data}' の次には、要素ノードが見つかりませんでした。\n";
54        }
55    } else {
56        echo "指定されたテキストノードが見つかりませんでした。\n";
57    }
58
59    echo "\n--- DOMComment ノードの nextElementSibling の例 ---\n";
60
61    // 次に、コメントノードの次の兄弟要素を取得する例を示します。
62    // 「<!-- これはコメントです -->」というDOMCommentノードを探します。
63    $queryCommentNode = "//div[@id='container']/comment()";
64    $targetCommentNodeList = $xpath->query($queryCommentNode);
65
66    if ($targetCommentNodeList->length > 0) {
67        /** @var DOMComment $targetCommentNode DOMCharacterData を継承する DOMComment ノード */
68        $targetCommentNode = $targetCommentNodeList->item(0);
69
70        echo "ターゲットノード (DOMComment) のデータ: '{$targetCommentNode->data}'\n";
71
72        // nextElementSibling プロパティを使用して、次の兄弟要素ノードを取得します。
73        // 「<!-- これはコメントです -->」の次にあるテキストノードをスキップし、
74        // その次の <span> 要素が取得されます。
75        $nextElementFromComment = $targetCommentNode->nextElementSibling;
76
77        if ($nextElementFromComment instanceof DOMElement) {
78            echo "見つかった次の兄弟要素:\n";
79            echo "  タグ名: {$nextElementFromComment->tagName}\n";
80            echo "  コンテンツ: '{$nextElementFromComment->textContent}'\n";
81        } else {
82            echo "ターゲットコメントノードの次には、要素ノードが見つかりませんでした。\n";
83        }
84    } else {
85        echo "指定されたコメントノードが見つかりませんでした。\n";
86    }
87
88    echo "\n--- 兄弟要素がない場合の nextElementSibling の例 ---\n";
89
90    // 最後のノードの nextElementSibling は null になることを示します。
91    // 「最後のテキストです。」というDOMTextノードを探します。
92    $queryLastTextNode = "//div[@id='container']/text()[normalize-space(.)='最後のテキストです。']";
93    $lastTextNodeList = $xpath->query($queryLastTextNode);
94
95    if ($lastTextNodeList->length > 0) {
96        /** @var DOMText $lastTextNode */
97        $lastTextNode = $lastTextNodeList->item(0);
98
99        echo "ターゲットノード (DOMText) のデータ: '{$lastTextNode->data}'\n";
100
101        $nextElementFromLast = $lastTextNode->nextElementSibling;
102
103        if ($nextElementFromLast instanceof DOMElement) {
104            echo "見つかった次の兄弟要素 (これは表示されないはず):\n";
105            echo "  タグ名: {$nextElementFromLast->tagName}\n";
106        } else {
107            // 期待通り、次の兄弟要素が見つからないため null が返され、このメッセージが表示されます。
108            echo "ターゲットノード '{$lastTextNode->data}' の次には、要素ノードが見つかりませんでした (期待通り null)。\n";
109        }
110    } else {
111        echo "最後のテキストノードが見つかりませんでした。\n";
112    }
113}
114
115// 上記で定義した関数を実行し、nextElementSibling の動作を確認します。
116showNextElementSiblingExample();
117

PHPのDOMCharacterDataクラスに属するnextElementSiblingは、現在のノードの次にある最も近い兄弟要素（DOMElement）を取得するためのプロパティです。このプロパティは引数を取らず、戻り値としてDOMElementオブジェクトを返しますが、次の兄弟要素が見つからない場合はnullを返します。

nextElementSiblingの主な特徴は、現在のノードの次にある兄弟ノードがテキストノードやコメントノードであっても、それらを自動的にスキップして、次に現れる要素ノードだけを探す点です。これにより、HTMLやXML文書内で要素ノードだけを効率的に辿ることができます。

サンプルコードでは、まずHTML文字列をDOMDocumentとして読み込みます。「もう一つのテキストです。」というテキストノードや、「」というコメントノードを対象にnextElementSiblingを使用する例を示しています。これらのノードの次には、テキストノードやコメントノードが続くこともありますが、nextElementSiblingはそれらをスキップし、「これはスパン要素です。」という次の要素ノードを正確に取得します。また、最後のテキストノードの後に兄弟要素が存在しない場合はnullが返されることも示されており、このプロパティの挙動を包括的に確認できます。

nextElementSiblingは、現在のノードの次の兄弟要素（DOMElement）を検索し、返します。テキストノードやコメントノードは自動的にスキップされます。このプロパティは、DOMCharacterDataを継承するDOMTextやDOMCommentなどのノードで使用できます。注意点として、次の兄弟要素が見つからない場合はnullが返されます。そのため、返り値がnullでないか、またDOMElement型であるかをif ($nextElement instanceof DOMElement)のように必ず確認するコードを記述してください。この確認を怠ると、存在しないプロパティへアクセスしようとしてエラーになる可能性があります。安全なコードのためには、このnullと型のチェックが不可欠です。