HTML DOM getElementsByClassName()Método

元素对象参考手册Objeto elemento

Ejemplo

En la lista de class="example", modifica el texto del primer elemento (índice 0) de class="child":

var list = document.getElementsByClassName("example")[0];
list.getElementsByClassName("child")[0].innerHTML = "Milk";

Antes de modificar el texto:

  • Coffee
  • Tea

Después de modificar el texto:

  • Milk
  • Tea

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 de nodos ordenada. Podemos acceder a los nodos de la lista mediante el número de índice del nodo en la lista de nodos (el índice comienza desde 0).

Consejo: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.


Compatibilidad del navegador

Los números en la tabla indican la primera versión del navegador que soporta este método.

Método
getElementsByClassName() 4.0 9.0 3.0 3.1 9.5

Sintaxis

element.getElementsByClassName(classname)

Valores de parámetros

Parámetro Tipo Descripción
classname String Obligatorio. El nombre de clase del elemento que necesitas obtener.

Varios nombres de clase se separan con espacios, como "test demo".

Descripción técnica

DOM Version: Core Level 1 Element Object
Return Value: Objeto NodeList que representa la colección de elementos con el nombre de clase especificado. El orden de los elementos en la colección es el orden en que aparecen en el código.

Examples

Más ejemplos

Ejemplo

Modifica el color de fondo del segundo elemento class="child" dentro del elemento <div>:

var x = document.getElementById("myDIV");
x.getElementsByClassName("child")[1].style.backgroundColor = "red";

Pruébalo »

Ejemplo

Comprueba cuántos elementos class="child" hay en el elemento <div> (usando la propiedad length del NodeList):

var x = document.getElementById("myDIV").getElementsByClassName("child").length;

xEl resultado es:

3

Pruébalo »

Ejemplo

Modifica el color de fondo del primer elemento con las clases "child" y "color" dentro del elemento class="example":

var x = document.getElementsByClassName("example")[1];
x.getElementsByClassName("child color")[0].style.backgroundColor = "red";

Pruébalo »

Ejemplo

Modifica el color de fondo de todos los elementos class="child" dentro del elemento <div>:

var x = document.getElementById("myDIV");
var y = x.getElementsByClassName("child");
var i;
for (i = 0; i < y.length; i++) {
  y[i].style.backgroundColor = "red";
}

Pruébalo »

Artículos relacionados

Tutorial de CSS:Selectores CSS

Manual de referencia de CSS:CSS .classSelectores

Manual de referencia de HTML DOM:document.getElementsByClassName()

Manual de referencia de HTML DOM:Propiedad className

Manual de referencia de HTML DOM:Objeto Style de HTML DOM


元素对象参考手册Objeto elemento

Otras extensiones