HTML DOM classListプロパティ

元素对象参考手册要素オブジェクト

例

<div> 要素に class を追加:

document.getElementById("myDIV").classList.add("mystyle");

試してみる »

定義と用法

classList プロパティは、要素のクラス名を DOMTokenList オブジェクトとして返します。

このプロパティは、要素の CSS クラスの追加、削除、切り替えに使用します。

classList プロパティは読み取り専用ですが、add() および remove() メソッドを使って変更できます。


ブラウザサポート

表内の数字は、そのプロパティをサポートする最初のブラウザのバージョン番号を示します。

プロパティ
classList 8.0 10.0 3.6 5.1 11.5

構文

element.classList

Properties

プロパティ Description
length クラスリスト内のクラスの数を返します

このプロパティは読み取り専用です

メソッド

メソッド 説明
add(class1, class2, ...) 要素に1つ以上のクラス名を追加します。

指定したクラス名が既に存在する場合は追加されません
contains(class) 指定したクラス名が存在するかどうかを示すブール値を返します。

可能な値:

  • true - 要素にすでにそのクラス名が含まれています
  • false - 要素にそのクラス名が存在しません
item(index) 要素内のインデックス値に対応するクラス名を返します。インデックス値は 0 から始まります。

インデックス値が範囲外の場合は null を返します。null
remove(class1, class2, ...) 要素から1つ以上のクラス名を削除します。

注意:存在しないクラス名を削除しても、エラーは発生しません。
toggle(class, true|false) 要素内のクラス名を切り替えます。

最初のパラメータは要素から削除するクラス名で、false を返します。
そのクラス名が存在しない場合は、要素にクラス名を追加し、true を返します。

2番目のパラメータはオプションで、クラス名の存在に関係なく、要素にクラスを強制的に追加または削除するかどうかを設定するブール値です。例:

1つの class を削除:element.classList.toggle("classToRemove", false);
1つの class を追加:element.classList.toggle("classToAdd", true);

注意:Internet Explorer または Opera 12 およびそれ以前のバージョンは、2番目のパラメータをサポートしていません。

技術説明

戻り値: 要素のクラス名リストを含む DOMTokenList

实例

その他の例

例

<div> 要素に複数のクラスを追加:

document.getElementById("myDIV").classList.add("mystyle", "anotherClass", "thirdClass");

試してみる »

例

<div> 要素から1つのクラスを削除:

document.getElementById("myDIV").classList.remove("mystyle");

試してみる »

例

<div> 要素から複数のクラスを削除:

document.getElementById("myDIV").classList.remove("mystyle", "anotherClass", "thirdClass");

試してみる »

例

<div> 要素のクラスを切り替え:

document.getElementById("myDIV").classList.toggle("newClassName");

試してみる »

例

<div> 要素のクラス名を取得:

<div id="myDIV" class="mystyle anotherClass thirdClass">I am a DIV element</div>

var x = document.getElementById("myDIV").classList;

x出力結果は次のとおりです:

mystyle anotherClass thirdClass

試してみる »

例

<div> 要素のクラス名の数を確認:

var x = document.getElementById("myDIV").classList.length;

x出力結果は次のとおりです:

3

試してみる »

例

<div> 要素の最初のクラス名(インデックス0)を取得:

var x = document.getElementById("myDIV").classList.item(0);

x出力結果は次のとおりです:

mystyle

試してみる »

例

要素に "mystyle" クラスが存在するかどうかを確認:

var x = document.getElementById("myDIV").classList.contains("mystyle");

x出力結果は次のとおりです:

true

試してみる »

例

要素に "mystyle" クラスが存在するかどうかを確認し、存在する場合は別のクラス名を削除します:

var x = document.getElementById("myDIV");

if (x.classList.contains("mystyle")) {
    x.classList.remove("anotherClass");
} else {
    alert("Could not find it.");
}

試してみる »

関連記事

CSS チュートリアル:CSS セレクタ

CSS リファレンス:CSS .classセレクタ

HTML DOM リファレンス:HTML DOM className プロパティ

HTML DOM リファレンス:HTML DOM getElementsByClassName() メソッド

HTML DOM リファレンス:HTML DOM Style オブジェクト

元素对象参考手册要素オブジェクト

その他の拡張