HTML DOM getElementsByClassName()Método

Document 对象参考手册Objeto Document

Ejemplo

Obtener todos los elementos con el nombre de clase especificado:

var x = document.getElementsByClassName("example");

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

document.getElementsByClassName(classname)

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:

var x = document.getElementsByClassName("example color");

Pruébalo »

Ejemplo

Ver cuántos elementos de estilo class="example" hay en el documento (usando la propiedad length del NodeList):

var x = document.getElementsByClassName("example").length;

Pruébalo »

Ejemplo

Modificar el color de fondo de todos los elementos de estilo class="example":

var x = document.getElementsByClassName("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


Document 对象参考手册Objeto Document

Otras extensiones