HTML DOM getElementsByClassName()メソッド
定義と使用
getElementsByClassName() メソッドは、ドキュメント内の指定されたクラス名を持つすべての要素のコレクションを NodeList オブジェクトとして返します。
NodeList オブジェクトは、順序付けられたノードのリストを表します。NodeList オブジェクトでは、ノードリスト内のノードのインデックス番号(インデックスは0から始まります)を使用して、リスト内のノードにアクセスできます。
ヒント:NodeList オブジェクトの lengthプロパティを使用して、指定されたクラス名の要素の数を確認し、各要素をループして必要な要素を取得できます。
ブラウザのサポート
表内の数字は、そのメソッドをサポートする最初のブラウザのバージョン番号を示します。
| メソッド | |||||
|---|---|---|---|---|---|
| getElementsByClassName() | 4.0 | 9.0 | 3.0 | 3.1 | 9.5 |
構文
document.getElementsByClassName(classname)
パラメータ
| パラメータ | 型 | Description |
|---|---|---|
| classname | String | 必須。取得する要素のクラス名。 複数のクラス名はスペースで区切ります。例: "test demo"。 |
技術的な説明
| DOM バージョン: | Core Level 1 Document Object |
|---|---|
| 戻り値: | 指定されたクラス名を持つ要素のコレクションを表す NodeList オブジェクト。コレクション内の要素の順序は、コード内での出現順に並べられます。 |
その他の例
例
"example" と "color" クラス名を含むすべての要素を取得し、その色を変更する:
var x =
document.getElementsByClassName("example color");
試してみる »
例
ドキュメント内に class="example" スタイルの要素がいくつあるかを確認する(NodeList の length プロパティを使用):
var x =
document.getElementsByClassName("example").length;
試してみる »
例
class="example" スタイルを持つすべての要素の背景色を変更する:
var x = document.getElementsByClassName("example");
var i;
for (i = 0; i < x.length; i++) {
x[i].style.backgroundColor = "red";
}
var i;
for (i = 0; i < x.length; i++) {
x[i].style.backgroundColor = "red";
}
試してみる »
関連ページ
CSS チュートリアル:CSS セレクター
CSS リファレンス:CSS .classセレクター
HTML DOM リファレンス:element.getElementsByClassName()
HTML DOM リファレンス:className プロパティ
HTML DOM リファレンス:HTML DOM classList プロパティ
HTML DOM リファレンス:HTML DOM Style オブジェクト
その他の拡張
Document オブジェクト