DOM HTML getElementsByClassName()Méthode

Document 对象参考手册Objet Document

Exemple

Obtenir tous les éléments ayant le nom de classe spécifié :

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

Essayez-le vous-même »

Définition et utilisation

La méthode getElementsByClassName() renvoie une collection de tous les éléments ayant le nom de classe spécifié dans le document, sous la forme d'un objet NodeList.

L'objet NodeList représente une liste ordonnée de nœuds. Dans l'objet NodeList, nous pouvons accéder aux nœuds de la liste par leurs numéros d'index (à partir de 0).

Astuce :Vous pouvez utiliser l'objet NodeList et sa propriété lengthpour déterminer le nombre d'éléments ayant le nom de classe spécifié, et parcourir les éléments pour obtenir celui dont vous avez besoin.


Prise en charge des navigateurs

Les nombres dans le tableau spécifient la première version de navigateur qui prend entièrement en charge la méthode.

Méthode
getElementsByClassName() 4.0 9.0 3.0 3.1 9.5

Syntaxe

document.getElementsByClassName(classname)

Parameters

Paramètre Type Description
classname String Obligatoire. Le nom de classe du ou des élément(s) que vous souhaitez obtenir.

Plusieurs noms de classe sont séparés par des espaces, comme "test demo".

Détails techniques

Version DOM : Objet Document Core Level 1
Valeur de retour : Un objet NodeList, représentant une collection d'éléments ayant le nom de classe spécifié. Les éléments sont triés dans l'ordre où ils apparaissent dans le code.

实例

Plus d’exemples

Exemple

Obtenez tous les éléments ayant les noms de classe "example" et "color", et changez leur couleur :

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

Essayez-le vous-même »

Exemple

Découvrez combien d'éléments avec class="example" se trouvent dans le document (en utilisant la propriété length de l'objet NodeList) :

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

Essayez-le vous-même »

Exemple

Changez la couleur d'arrière-plan de tous les éléments avec class="example" :

var x = document.getElementsByClassName("example");
var i;
for (i = 0; i < x.length; i++) {
    x[i].style.backgroundColor = "red";
}

Essayez-le vous-même »

Pages associées

Tutoriel CSS :Sélecteurs CSS

Référence CSS :CSS .classSélecteurs

Référence HTML DOM :élément.getElementsByClassName()

Référence HTML DOM :Propriété className

Référence HTML DOM :Propriété classList du DOM HTML

Référence HTML DOM :Objet Style HTML DOM


Document 对象参考手册Objet Document

Autres extensions