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

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

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

基本的な使い方

nextElementSiblingプロパティは、DOMTextノードの次の兄弟要素ノードを取得するプロパティです。DOM（Document Object Model）は、HTMLやXMLドキュメントをプログラムから操作するためのインターフェースであり、ドキュメントをツリー構造として表現します。このツリー構造において、あるノードの直後に同じ親を持つ要素ノードが、兄弟要素ノードとなります。

DOMTextクラスは、テキストノードを表すクラスです。テキストノードは、HTMLやXMLドキュメント内のテキストを表します。nextElementSiblingプロパティを使用することで、テキストノードの直後にある要素ノードを簡単に取得することができます。もし、テキストノードの直後に要素ノードが存在しない場合、nextElementSiblingプロパティはnullを返します。

このプロパティは、DOMツリーをナビゲートし、特定の要素ノードを効率的に見つけ出すために非常に役立ちます。例えば、特定のテキストノードの直後にある要素の属性を調べたり、スタイルを変更したりする際に利用できます。

システムエンジニアを目指す上で、DOMの構造を理解し、nextElementSiblingのようなプロパティを使いこなせることは、Webアプリケーション開発において非常に重要です。なぜなら、WebアプリケーションはHTMLやXMLなどのドキュメントを扱うことが多く、DOMを介してこれらのドキュメントを操作する必要があるからです。

構文(syntax)


1DOMText::$nextElementSibling;

引数(parameters)

引数なし

引数はありません

戻り値(return)

DOMElement|null

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

サンプルコード

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


1<?php
2
3/**
4 * DOMText::nextElementSibling プロパティの使用例をデモンストレーションします。
5 *
6 * この関数は、HTML文字列を解析し、個々のDOMTextノードの次の兄弟要素（DOMElement）を特定します。
7 * 次の兄弟がDOMElementである場合はその情報を、そうでない場合はnullであることを表示します。
8 */
9function demonstrateNextElementSibling(): void
10{
11    // 解析するHTML文字列を定義します。
12    // 複数のテキストノードとその間に挟まれた要素、またはその後に要素がないテキストノードを含めます。
13    $html = <<<HTML
14    <div>
15        <!-- テキスト1の次の要素は<p>タグ -->
16        テキスト1
17        <p>最初のパラグラフ</p>
18        <!-- テキスト2の次の要素は<span>タグ -->
19        テキスト2
20        <span>次のスパン</span>
21        <!-- テキスト3の次には要素がありません -->
22        テキスト3
23        <!-- 空白のみのテキストノードは一般的に無視されますが、nextElementSiblingは正しくnullを返します -->
24    </div>
25    HTML;
26
27    // DOMDocumentインスタンスを作成し、HTMLをロードします。
28    // LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD は、余分な<html><body>タグが自動的に追加されるのを防ぎます。
29    // @ は、HTML解析に関する警告（例: HTML5タグの不明なエラー）を抑制するために使用します。
30    $dom = new DOMDocument();
31    @$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
32
33    // DOMXPathインスタンスを作成し、ドキュメント内のすべてのテキストノードを選択します。
34    // XPathクエリ "//text()" は、すべてのノードの子孫であるテキストノードを意味します。
35    $xpath = new DOMXPath($dom);
36    $textNodes = $xpath->query('//text()');
37
38    echo "--- DOMText::nextElementSibling のデモンストレーション ---\n\n";
39
40    // 取得した各テキストノードをループ処理します。
41    foreach ($textNodes as $textNode) {
42        // 空白のみのテキストノード（HTML整形のための改行やスペースなど）はスキップします。
43        // これにより、意味のあるテキストノードに焦点を当てます。
44        if (trim($textNode->nodeValue) === '') {
45            continue;
46        }
47
48        echo "現在のテキストノード: '" . trim($textNode->nodeValue) . "'\n";
49
50        // DOMText::nextElementSibling プロパティにアクセスし、次の兄弟要素を取得します。
51        // 次の兄弟が要素でない場合（例: テキストノードやコメントノード）、または存在しない場合は null が返されます。
52        $nextElement = $textNode->nextElementSibling;
53
54        if ($nextElement !== null) {
55            // 次の兄弟がDOMElementの場合、そのタグ名と内容を出力します。
56            echo "  -> 次の兄弟要素: <" . $nextElement->tagName . "> ('" . trim($nextElement->nodeValue) . "')\n";
57        } else {
58            // 次の兄弟がDOMElementでない場合（または存在しない場合）は "なし" と出力します。
59            echo "  -> 次の兄弟要素: なし (null)\n";
60        }
61        echo "\n";
62    }
63
64    echo "---------------------------------------------------\n";
65}
66
67// デモンストレーション関数を実行します。
68demonstrateNextElementSibling();

PHPのDOMText::nextElementSiblingプロパティは、HTMLやXMLドキュメント内で、特定のテキストノードの直後に位置する「次の兄弟要素」を取得するために使用されます。このプロパティは引数を一切取りません。戻り値は、次の兄弟がDOM要素（やなどのタグ）であればそのDOMElementオブジェクトを返します。もし次の兄弟ノードが存在しない場合や、存在してもそれがテキストノードやコメントノードなどDOMElement以外のノードである場合には、nullを返します。

提供されたサンプルコードでは、まずHTML文字列を解析し、その中に含まれるすべてのテキストノードを抽出しています。その後、それぞれのテキストノードに対してnextElementSiblingプロパティを適用し、その結果を表示しています。これにより、「テキスト1」の次にタグがある場合はその要素情報が取得され、「テキスト3」のように次の兄弟が要素ではない場合にはnullが返される様子が確認できます。このプロパティを使うことで、HTMLの構造をプログラムで正確に解析し、テキストのすぐ隣にある要素を効率的に特定することができます。

このサンプルコードは、DOMText::nextElementSiblingプロパティがテキストノードの「次の兄弟要素」のみを取得する点を示しています。そのため、次の兄弟が要素ではない場合（例えば別のテキストノードやコメントノード）、戻り値はnullとなりますので、必ずnullチェックを行ってから利用してください。

HTMLをパースする際、整形目的の改行やスペースなどもテキストノードとして扱われるため、意図しない空白だけのテキストノードをスキップする処理（trimを使った判定）が重要です。また、DOMDocument::loadHTMLで@演算子を使って警告を抑制していますが、実際の開発ではエラーログを適切に確認し、潜在的な問題を把握するよう注意してください。これらの点を理解し、安全にコードを利用することが大切です。

PHP DOMText::nextElementSibling で次の要素を取得する


1<?php
2
3/**
4 * DOMText::nextElementSibling プロパティの使用例を示す関数
5 *
6 * この関数は、HTML文字列から特定のテキストノードを見つけ、
7 * その次の兄弟要素（DOMElement）を取得し、結果を表示します。
8 * nextElementSiblingは、兄弟ノードが要素でない場合（テキストノード、コメントノードなど）や、
9 * 次の兄弟ノードが存在しない場合に null を返します。
10 *
11 * システムエンジニアを目指す初心者にもわかるように、具体的な例を通して
12 * プロパティの動作を説明します。
13 */
14function demonstrateNextElementSibling(): void
15{
16    // 処理対象となるHTML文字列を定義します。
17    // さまざまなタイプの兄弟ノードを持つテキストノードを含めています。
18    $html = <<<HTML
19    <div>
20        <p>最初の段落。</p>
21        <!-- これはコメントノードです。 -->
22        テキストノードA
23        <span>これはSPAN要素です。</span>
24        テキストノードB
25        <b>これはB要素です。</b>
26        テキストノードC
27        <!-- 最後のテキストノードの後には要素がありません。 -->
28    </div>
29    HTML;
30
31    // DOMDocumentオブジェクトを作成し、HTMLをロードします。
32    $dom = new DOMDocument();
33    // loadHTML()はHTMLを解析し、DOMツリーを構築します。
34    // @ を使用して、HTMLの構造が不完全な場合に出る警告を抑制しています。
35    // LIBXML_HTML_NOIMPLIED と LIBXML_HTML_NODEFDTD は、
36    // 余分な <html> や <body> タグ、DOCTYPE宣言が自動的に追加されるのを防ぎます。
37    @$dom->loadHTML($html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
38
39    // DOMXPathオブジェクトを初期化します。
40    // DOMXPathは、DOMツリー内の特定のノードを検索するための強力なツールです。
41    $xpath = new DOMXPath($dom);
42
43    // --- 例1: 次の兄弟がDOMElementであるケース ---
44    // 'テキストノードA' を含むDOMTextノードをXPathで検索します。
45    $textNodeA = $xpath->query("//text()[contains(., 'テキストノードA')]")->item(0);
46
47    echo "--- 例1: 'テキストノードA' の次 ---" . PHP_EOL;
48    if ($textNodeA instanceof DOMText) {
49        echo "  見つかったテキストノード: '" . trim($textNodeA->nodeValue) . "'" . PHP_EOL;
50
51        // DOMText::nextElementSibling プロパティを使って、次の兄弟要素を取得します。
52        $nextElement = $textNodeA->nextElementSibling;
53
54        if ($nextElement instanceof DOMElement) {
55            echo "  次の兄弟要素が見つかりました。" . PHP_EOL;
56            echo "  要素名: " . $nextElement->tagName . PHP_EOL;
57            echo "  textContent: '" . trim($nextElement->textContent) . "'" . PHP_EOL;
58        } else {
59            echo "  次の兄弟要素は見つかりませんでした (null または要素ではないノードでした)。" . PHP_EOL;
60        }
61    } else {
62        echo "  'テキストノードA' が見つかりませんでした。" . PHP_EOL;
63    }
64    echo PHP_EOL;
65
66    // --- 例2: 次の兄弟がDOMElementであるケース (別パターン) ---
67    // 'テキストノードB' を含むDOMTextノードをXPathで検索します。
68    $textNodeB = $xpath->query("//text()[contains(., 'テキストノードB')]")->item(0);
69
70    echo "--- 例2: 'テキストノードB' の次 ---" . PHP_EOL;
71    if ($textNodeB instanceof DOMText) {
72        echo "  見つかったテキストノード: '" . trim($textNodeB->nodeValue) . "'" . PHP_EOL;
73
74        // DOMText::nextElementSibling プロパティを使って、次の兄弟要素を取得します。
75        $nextElement = $textNodeB->nextElementSibling;
76
77        if ($nextElement instanceof DOMElement) {
78            echo "  次の兄弟要素が見つかりました。" . PHP_EOL;
79            echo "  要素名: " . $nextElement->tagName . PHP_EOL;
80            echo "  textContent: '" . trim($nextElement->textContent) . "'" . PHP_EOL;
81        } else {
82            echo "  次の兄弟要素は見つかりませんでした (null または要素ではないノードでした)。" . PHP_EOL;
83        }
84    } else {
85        echo "  'テキストノードB' が見つかりませんでした。" . PHP_EOL;
86    }
87    echo PHP_EOL;
88
89    // --- 例3: 次の兄弟要素が存在しないケース (null が返る) ---
90    // 'テキストノードC' を含むDOMTextノードをXPathで検索します。
91    $textNodeC = $xpath->query("//text()[contains(., 'テキストノードC')]")->item(0);
92
93    echo "--- 例3: 'テキストノードC' の次 ---" . PHP_EOL;
94    if ($textNodeC instanceof DOMText) {
95        echo "  見つかったテキストノード: '" . trim($textNodeC->nodeValue) . "'" . PHP_EOL;
96
97        // DOMText::nextElementSibling プロパティを使って、次の兄弟要素を取得します。
98        // この場合、HTMLの構造上、'テキストノードC' の次には要素がありません。
99        $nextElement = $textNodeC->nextElementSibling;
100
101        if ($nextElement instanceof DOMElement) {
102            // このブロックは実行されません。
103            echo "  次の兄弟要素が見つかりました。" . PHP_EOL;
104            echo "  要素名: " . $nextElement->tagName . PHP_EOL;
105            echo "  textContent: '" . trim($nextElement->textContent) . "'" . PHP_EOL;
106        } else {
107            echo "  次の兄弟要素は見つかりませんでした (null が返されました)。" . PHP_EOL;
108        }
109    } else {
110        echo "  'テキストノードC' が見つかりませんでした。" . PHP_EOL;
111    }
112}
113
114// 上記のデモンストレーション関数を実行します。
115demonstrateNextElementSibling();

PHPのDOMText::nextElementSiblingプロパティは、HTMLやXML文書の構造をプログラムで扱う際に使用されます。このプロパティは、特定のテキストノードの「次に位置する兄弟要素」を効率的に取得するために利用されます。

DOMTextクラスのインスタンスからこのプロパティにアクセスし、引数を取ることはありません。戻り値は、テキストノードの次にDOM要素（HTMLタグで囲まれた部分）が存在すれば、そのDOMElementオブジェクトを返します。もし、次に要素が存在しない場合（例えば、次のノードがコメントノードや別のテキストノードである場合、あるいは単純に次のノードがない場合）はnullを返します。このプロパティは、コメントノードや他のテキストノードといった要素以外の兄弟ノードを自動的にスキップし、次に最も近い要素を探し出す点が特徴です。

サンプルコードでは、まずHTML文字列を解析してDOMツリーを構築しています。そして、DOMXPathを使って「テキストノードA」「テキストノードB」「テキストノードC」という特定のテキストノードを見つけ出します。それぞれのテキストノードに対してnextElementSiblingプロパティを適用することで、「テキストノードA」の次の要素、「テキストノードB」の次の要素といった具体的な兄弟要素を取得できることを示しています。また、「テキストノードC」の例では、その次に要素が存在しないため、nullが返される挙動も確認できます。このように、Webページのテキストコンテンツとその周りの要素の関係性をプログラムで処理する際に役立ちます。

nextElementSiblingプロパティは、対象のDOMTextノードの「次の兄弟要素」のみを返します。このプロパティがDOMElement型を返すのは、本当に次の兄弟がHTML要素である場合だけです。もし次の兄弟ノードがテキストノード、コメントノードなど要素ではない場合、または次の兄弟ノード自体が存在しない場合はnullを返します。したがって、取得した値を使用する前には、必ずif ($nextElement instanceof DOMElement)のように、DOMElement型であるか、nullでないかをチェックするようにしてください。サンプルコードのDOMDocument::loadHTML()で使用している@記号によるエラー抑制は、本番環境では避け、HTML構造のエラーがないかを確認することが重要です。HTMLの構造によって結果が変わるため、意図しない挙動を防ぐために十分なテストを行うことをおすすめします。