HTML DOM getElementsByClassName()メソッド

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

例

class="example" のリスト内で class="child" の最初の項目(インデックス値 0)のテキストを変更:

var list = document.getElementsByClassName("example")[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

構文

element.getElementsByClassName(classname)

パラメータ値

パラメータ 型 説明
classname String 必須。取得する要素のクラス名です。

複数のクラス名はスペースで区切ります(例: "test demo")。

技術的な説明

DOM Version: Core Level 1 Element Object
Return Value: NodeList オブジェクト。指定されたクラス名の要素のコレクションを表します。コレクション内の要素の順序は、コード内での出現順に並べ替えられます。

Examples

その他の例

例

<div> 要素内の 2 番目の class="child" 要素の背景色を変更:

var x = document.getElementById("myDIV");
x.getElementsByClassName("child")[1].style.backgroundColor = "red";

試してみる »

例

<div> 要素内に class="child" の要素がいくつあるかを確認(NodeList の length プロパティを使用):

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

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

3

試してみる »

例

class="example" 要素内の最初のクラス名 "child" と "color" 要素の背景色を変更:

var x = document.getElementsByClassName("example")[1];
x.getElementsByClassName("child color")[0].style.backgroundColor = "red";

試してみる »

例

<div> 要素内の class="child" のすべての要素の背景色を変更:

var x = document.getElementById("myDIV");
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 オブジェクト


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

その他の拡張機能