Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.
El método Element.getElementsByClassName()
retorna una HTMLCollection
"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étodo Document.getElementsByClassName()
actúa en todo el documento; retornará los elementos que sean descendientes del documento raiz especificado que tengan los nombres de clase dados.
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
Element
de un documento.
Ejemplo
Obtiene todos los elementos que tienen una clase test
:
element.getElementsByClassName('test');
Obtiene todos los elementos que tienen tanto la clase red
como test
:
element.getElementsByClassName('red test');
Obtiene todos los elementos que tienen la clase of test
, dentro de un elemento que tiene el id
main
:
document.getElementById('main').getElementsByClassName('test');
Podemos también usar métodos de Array.prototype
en cualquier HTMLCollection
pasando el HTMLCollection
como el valor this del método. Aquí encontramos todos los elementos <div>
que tienen una clase test
:
var testElements = document.getElementsByClassName('test'); var testDivs = Array.prototype.filter.call(testElements, function(testElement){ return testElement.nodeName === 'div'; });
Especificaciones
Especificación | Estado | Observaciones |
---|---|---|
DOM The definition of 'Element.getElementsByClassName()' in that specification. |
Living Standard | Definición inicial |
Compatibilidad con navegadores
Prestación | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Soporte básico | (Yes) | (Yes) [1] | 9 | (Yes) | (Yes) [2] |
Prestación | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Soporte básico | ? | ? [1] | ? | ? | ? |
[1] Anteriormente a Firefox 19, este método retornaba una NodeList
; se cambió para reflejar el cambio en la especificación.
[2] Safari en iOS 8 y OS X 10.10 retorna una NodeList
.