【PHP8.x】Dom\HTMLElement::nodeNameプロパティの使い方

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

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

基本的な使い方

nodeNameプロパティは、Dom\HTMLElementクラスに属するプロパティで、HTMLやXMLドキュメント内の特定の要素（Element）のノード名、つまりタグ名を文字列として保持します。このプロパティを利用することで、プログラム上で要素がどのような種類であるかを簡単に判別できるようになります。

たとえば、<p>タグで記述された段落要素や、<div>タグで記述されたブロック要素など、さまざまなHTML要素が存在します。Dom\HTMLElementオブジェクトからnodeNameプロパティにアクセスすると、これらの要素のタグ名が文字列として取得できます。HTMLドキュメントの場合、通常はタグ名が大文字で返されます。具体的には、<p>要素であれば"P"、<div>要素であれば"DIV"という文字列が得られます。

このプロパティは、DOM（Document Object Model）ツリーを走査しながら特定のタグを持つ要素を探したり、要素の種類に応じて異なる処理を実行したりする場合に特に役立ちます。例えば、「すべての<a>タグ（アンカー要素）を対象に特定の属性を追加する」といった処理を行う際に、要素が<a>タグであるかどうかの判別に使用できます。

XMLドキュメントなど、HTML以外のDOM要素を扱う場合、nodeNameは元のタグ名（大文字・小文字を区別したまま）を返すことがありますので、注意が必要です。nodeNameプロパティは、要素の基本的な識別情報を提供し、DOM操作における条件分岐や情報取得の基礎となります。

構文(syntax)


1<?php
2
3$dom = new DOMDocument();
4$element = $dom->createElement('div');
5echo $element->nodeName;
6
7?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

このプロパティは、要素のノード名を文字列として返します。例えば、<p> タグであれば "p" が返されます。

サンプルコード

PHP DOM: nodeNameで要素のタグ名を取得する


1<?php
2
3/**
4 * Dom\HTMLElement::nodeName プロパティの使用例を示します。
5 * nodeName プロパティは、要素のタグ名（ノード名）を文字列として返します。
6 * システムエンジニアを目指す初心者向けに、基本的なDOM操作と合わせて解説します。
7 */
8function demonstrateDomNodeName(): void
9{
10    // 1. DOMDocument オブジェクトの作成
11    // これを使ってHTML文書をメモリ上にロードし、操作します。
12    $dom = new DOMDocument();
13
14    // 2. HTMLコンテンツのロード
15    // Dom\HTMLElement は、divやpなどのHTML要素を表すPHP 8で導入された型です。
16    // loadHTML() はHTML文字列を解析し、DOMツリーを構築します。
17    // エラーや警告が発生しても処理を続行するため、@ で抑制しています。
18    $htmlContent = '<html><body><div id="greeting">Hello, PHP DOM!</div><p>This is a paragraph.</p></body></html>';
19    @$dom->loadHTML($htmlContent);
20
21    // 3. 特定のHTML要素の取得
22    // IDが "greeting" の要素（この場合 <div>）を取得します。
23    // getElementById() は DOMElement オブジェクトを返しますが、
24    // PHP 8では DOMElement は Dom\HTMLElement を実装しています。
25    $elementById = $dom->getElementById('greeting');
26
27    // 4. Dom\HTMLElement の確認と nodeName プロパティへのアクセス
28    // 取得した要素が Dom\HTMLElement のインスタンスであることを確認します。
29    if ($elementById instanceof Dom\HTMLElement) {
30        // nodeName プロパティにアクセスし、要素のタグ名を取得します。
31        // <div> 要素の場合、"div" という文字列が返されます。
32        $nodeName = $elementById->nodeName;
33        echo "ID 'greeting' を持つ要素のノード名: " . $nodeName . PHP_EOL; // 出力: div
34    } else {
35        echo "ID 'greeting' を持つ要素が見つからないか、期待される型ではありません。" . PHP_EOL;
36    }
37
38    echo "--------------------" . PHP_EOL;
39
40    // 5. 別の例: タグ名で要素を取得し、nodeName を確認
41    // 文書内のすべての 'p' タグを取得します。
42    $paragraphs = $dom->getElementsByTagName('p');
43
44    if ($paragraphs->length > 0) {
45        // 最初の 'p' タグ要素を取得します。
46        $firstParagraph = $paragraphs->item(0);
47
48        // 再度、Dom\HTMLElement のインスタンスであることを確認します。
49        if ($firstParagraph instanceof Dom\HTMLElement) {
50            // 'p' タグの nodeName は "p" となります。
51            $nodeNameForParagraph = $firstParagraph->nodeName;
52            echo "最初の 'p' タグのノード名: " . $nodeNameForParagraph . PHP_EOL; // 出力: p
53        } else {
54            echo "最初の 'p' タグが期待される型ではありません。" . PHP_EOL;
55        }
56    } else {
57        echo "文書内に 'p' タグが見つかりませんでした。" . PHP_EOL;
58    }
59}
60
61// サンプル関数を実行します。
62demonstrateDomNodeName();
63

PHP 8で導入されたDom\HTMLElementクラスのnodeNameプロパティは、HTML文書内の特定の要素のタグ名（ノード名）を取得するために使用されます。Dom\HTMLElementは<div>や<p>といったHTML要素をオブジェクトとして表現し、このプロパティにアクセスすることで、その要素が何のタグであるかを簡単に判別できます。

サンプルコードではまず、DOMDocumentオブジェクトを作成し、指定されたHTMLコンテンツをメモリ上にロードしています。次に、getElementById()メソッドでIDが"greeting"の<div>要素を取得します。この取得された要素はDom\HTMLElementのインスタンスであり、$elementById->nodeNameと記述することで、そのタグ名である"div"という文字列が戻り値として得られます。

同様に、getElementsByTagName('p')で<p>タグを取得する例も示しています。ここでも、取得した<p>要素のnodeNameプロパティにアクセスすると、"p"という文字列が返されます。

このプロパティは引数を取らず、常に要素のタグ名を小文字の文字列（string）として返します。これにより、JavaScriptなどでHTML要素のtagNameプロパティを使うのと同様に、PHPのDOM操作において、現在扱っている要素がどのような種類であるかを確認する際に非常に役立ちます。システムエンジニアを目指す方にとって、DOM操作はWebアプリケーション開発の基本であり、nodeNameはその中でも要素の識別という重要な役割を担います。

Dom\HTMLElement::nodeNameプロパティの利用にあたり、まずDOMDocumentでHTMLをロードし、getElementByIdなどで目的の要素を確実に取得する手順を理解することが大切です。要素が見つからない場合はnullが返されるため、プロパティにアクセスする前に必ず有効な要素であることを確認してください。サンプルコードでは@によるエラー抑制がありますが、本番環境ではエラーハンドリングを適切に行い、問題の特定に努めることが推奨されます。nodeNameはHTML要素のタグ名を小文字の文字列として返しますので、この戻り値の特性を考慮して利用してください。PHP 8ではDOMElementがDom\HTMLElementインターフェースを実装しているため、instanceofによる型チェックが可能です。