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

classNameプロパティは、HTML要素のclass属性の値を保持するプロパティです。PHPのDOM拡張機能に属し、HTMLやXMLドキュメント内の要素をオブジェクトとして扱うDOMElementクラスの一部です。DOMElementクラスは、<p>や<div>といった個々のHTML要素を表現し、それらの属性や内容をプログラムから操作することを可能にします。

このclassNameプロパティは、特にHTML要素に対してCSSのスタイルを適用するために使われるclass属性の値を管理するために利用されます。要素に設定されているCSSクラス名を文字列として取得したり、新しいクラス名を要素に設定したりする際に使用できます。例えば、あるHTML要素にclass="primary-button large"という属性が設定されている場合、DOMElementオブジェクトのclassNameプロパティにアクセスすると、文字列"primary-button large"が得られます。

また、このプロパティに新しい文字列を代入することで、要素のclass属性の値を変更できます。複数のクラスを適用したい場合は、"class1 class2"のように半角スペースで区切って設定します。例えば、$element->className = "active highlighted";と設定すると、その要素にはactiveとhighlightedという二つのCSSクラスが適用され、関連するスタイルが反映されます。この機能は、ウェブページの見た目を動的に変更したり、特定の要素の振る舞いを制御したりする際に非常に役立ちます。

Copy
1<?php
2
3$dom = new DOMDocument('1.0', 'utf-8');
4$element = $dom->createElement('div');
5$element->className = 'example-class'; // クラス名を設定
6$dom->appendChild($element);
7
8echo $element->className; // 設定されたクラス名を取得して表示
9
10?>

引数なし

引数はありません

string

DOMElement オブジェクトのクラス名を文字列で返します。