Element.getElementsByClassName()

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.

Etiquetas y colaboradores del documento

 Colaboradores en esta página: Grijander81
 Última actualización por: Grijander81,