Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
Element.getElementsByClassName()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since octubre de 2017.
El métodoElement.getElementsByClassName() retorna unaHTMLCollection "viva" conteniendo todos los elementos hijos que tienen todos los nombres de clase dados. Cuando se llama en el objeto document, se realiza la búsqueda en el documento completo, incluyendo el nodo raíz.
De forma similar, el métodoDocument.getElementsByClassName() actúa en todo el documento; retornará los elementos que sean descendientes del documento raiz especificado que tengan los nombres de clase dados.
In this article
Sintaxis
var elements = element.getElementsByClassName(names);- elements es una
HTMLCollection"viva" de los elementos encontrados. - names es una cadena representando la lista de nombres de clase que deben concordar; los nombres de clase está separados por espacios en blanco.
- element es cualquier
Elementde un documento.
Ejemplo
Obtiene todos los elementos que tienen una clasetest:
element.getElementsByClassName("test");Obtiene todos los elementos que tienen tanto la clasered comotest:
element.getElementsByClassName("red test");Obtiene todos los elementos que tienen la clase oftest, dentro de un elemento que tiene elidmain:
document.getElementById("main").getElementsByClassName("test");Podemos también usar métodos deArray.prototype en cualquierHTMLCollection pasandoel HTMLCollection como el valorthis del método. Aquí encontramos todos los elementos<div> que tienen una clasetest:
var testElements = document.getElementsByClassName("test");var testDivs = Array.prototype.filter.call( testElements, function (testElement) { return testElement.nodeName === "div"; },);Especificaciones
| Specification |
|---|
| DOM> # ref-for-dom-element-getelementsbyclassname> |