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

classNameプロパティは、Dom\Elementオブジェクトが表すHTML要素のclass属性の値を保持するプロパティです。PHPのDOM拡張機能を使用してHTMLやXML文書の要素をプログラムで操作する際に、このプロパティは特定の要素に適用されているCSSクラス名を取得したり、新しいCSSクラス名を設定したりするために利用されます。

ウェブページでは、class属性は要素の見た目をCSSで定義したり、JavaScriptによって要素を動的に操作するための識別子として頻繁に用いられます。たとえば、特定のデザインを適用したい要素に対してクラス名を読み書きすることで、スタイルの変更や動作の切り替えをPHPコードから直接制御できます。

もし要素に複数のクラス名が設定されている場合、それらのクラス名は「class1 class2 class3」のようにスペースで区切られた一つの文字列として扱われます。このプロパティに新しい値を設定する際には、既存のclass属性全体が指定した文字列で上書きされることに注意が必要です。Dom\Element::classNameプロパティは、PHPのDOM拡張機能を使ってウェブコンテンツの構造や表現を柔軟に操作する上で、非常に基本的ながらも重要な役割を果たす機能の一つです。

Copy
1<?php
2
3// Dom\Documentのインスタンスを作成
4$document = new Dom\Document();
5// div要素を作成
6$element = $document->createElement('div');
7
8// 要素のclass属性を設定する構文
9$element->className = 'my-class another-class';
10
11// 要素のclass属性を取得する構文
12$currentClasses = $element->className;
13
14// $currentClasses には 'my-class another-class' が文字列として格納されます
15?>

引数なし

引数はありません

string

このプロパティは、DOM要素のclass属性の値を文字列として返します。