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