La méthodeElement.getElementsByClassName() retourne uneHTMLCollection contenant une référence sur tous les éléments ayant les noms de classes passés en paramètre. Quand la méthode est appelée sur l'objet document, la recherche s'effectue dans le document complet, noeud racine compris.

À l'instar de la méthodeDocument.getElementsByClassName() qui agit sur le document entier ; elle va retourner les descendants de l'élément spécifié comme document root qui auront les noms de classes passés en paramètre.

Syntaxe

var elements = element.getElementsByClassName(names);

• elements est uneHTMLCollection de référence vers les élements trouvés.
• names est une chaine représentant la liste des noms de classes à trouver; les noms de classes sont séparés par un espace.
• element est n'importe quelElement du document.

Exemples

Obtient tous les élements ayant une classetest:

element.getElementsByClassName("test");

Obtient tous les élements ayant à la fois la classered et la classetest:

element.getElementsByClassName("red test");

Obtient tous les élements qui ont une classetest, à l'intérieur d'un élement qui a pour idmain:

document.getElementById("main").getElementsByClassName("test");

On peut aussi utiliser les méthodes deArray.prototype sur chaqueHTMLCollection en passant laHTMLCollection comme valeurthis de la méthode. Ci-dessous on trouvera tous les<div> avec une classetest:

var testElements = document.getElementsByClassName("test");var testDivs = Array.prototype.filter.call(  testElements,  function (testElement) {    return testElement.nodeName === "div";  },);

Spécifications

Compatibilité des navigateurs