HTML DOM getElementsByClassName()メソッド

Document 对象参考手册Document オブジェクト

例

指定されたクラス名を持つすべての要素を取得する:

var x = document.getElementsByClassName("example");

試してみる »

定義と使用

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";
}

試してみる »

関連ページ

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

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

HTML DOM リファレンス:element.getElementsByClassName()

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

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

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


Document 对象参考手册Document オブジェクト

その他の拡張