HTML DOM classListプロパティ
定義と用法
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) | 指定したクラス名が存在するかどうかを示すブール値を返します。 可能な値:
|
| 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> 要素から複数のクラスを削除:
document.getElementById("myDIV").classList.remove("mystyle",
"anotherClass", "thirdClass");
試してみる »
例
<div> 要素のクラス名を取得:
<div id="myDIV" class="mystyle
anotherClass thirdClass">I am a DIV element</div>
var x = document.getElementById("myDIV").classList;
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.");
}
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 オブジェクト
その他の拡張
要素オブジェクト