HTML DOM getElementsByClassName()Método
Ejemplo
Obtener todos los elementos con el nombre de clase especificado:
Pruébalo »
Definición y uso
El método getElementsByClassName() devuelve una colección de todos los elementos con el nombre de clase especificado en el documento, como un objeto NodeList.
El objeto NodeList representa una lista ordenada de nodos. Podemos acceder a los nodos de la lista mediante el índice del nodo en la lista (el índice comienza en 0).
Sugerencia:Puedes usar la propiedad del objeto NodeList lengthpara determinar el número de elementos con el nombre de clase especificado y recorrer cada elemento para obtener el que necesitas.
Soporte del navegador
Los números en la tabla indican la versión del primer navegador que soporta el método.
| Método | |||||
|---|---|---|---|---|---|
| getElementsByClassName() | 4.0 | 9.0 | 3.0 | 3.1 | 9.5 |
Sintaxis
Parámetros
| Parámetro | Tipo | Description |
|---|---|---|
| classname | String | Obligatorio. El nombre de clase del elemento que necesitas obtener. Varios nombres de clase se separan con espacios, por ejemplo "test demo". |
Descripción técnica
| Versión DOM: | Core Level 1 Document Object |
|---|---|
| Valor de retorno: | Objeto NodeList, que representa el conjunto de elementos con el nombre de clase especificado. Los elementos del conjunto se ordenan según su orden de aparición en el código. |
Más ejemplos
Ejemplo
Obtener todos los elementos que contienen las clases "example" y "color", y modificar su color:
Pruébalo »
Ejemplo
Ver cuántos elementos de estilo class="example" hay en el documento (usando la propiedad length del NodeList):
Pruébalo »
Ejemplo
Modificar el color de fondo de todos los elementos de estilo class="example":
var i;
for (i = 0; i < x.length; i++) {
x[i].style.backgroundColor = "red";
}
Pruébalo »
Páginas relacionadas
Tutorial de CSS:Selectores CSS
Referencia de CSS:CSS .classSelectores
Referencia de HTML DOM:element.getElementsByClassName()
Referencia de HTML DOM:Propiedad className
Referencia de HTML DOM:Propiedad classList de HTML DOM
Referencia de HTML DOM:Objeto Style de HTML DOM
Otras extensiones
Objeto Document