English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Método getElementsByClassName() do HTML DOM

Objeto Elemento do HTML DOM

element.getElementsByClassName()Retorna um objeto de array de classe que contém todos os elementos filhos com o nome de classe especificado. Quando chamado no objeto document, ele busca todo o documento DOM, incluindo o nó raiz. Você também pode chamar o método getElementsByClassName() em qualquer elemento, que retornará todos os elementos filhos com o nome de classe especificado, a partir do nó atual como nó raiz.

A lista retornada é ordenada pela ordem de aparecimento dos elementos no código-fonte.

Pode-se acessar a lista retornada pelo índice. O índice começa em 0.

UsolengthA propriedade determina o número de elementos filhos com o nome de classe especificado, e então é possível percorrer todos os elementos e extrair a informação necessária.

Adocument.getElementsByClassName()O funcionamento do método é basicamente o mesmo, apenas ele atua sobre todo o documento, começando pelo nó raiz.

Sintaxe:

element.getElementsByClassName(class)
var gBox = document.getElementById("greenBox");
gBox.getElementsByClassName("demo")[0].innerHTML = "Hello World";
Teste e veja‹/›

Compatibilidade do Navegador

O método getElementsByClassName() é completamente suportado por todos os navegadores:

Método
getElementsByClassName()SimSimSimSimSim

Valor do Parâmetro

ParâmetroDescrição
classO nome da classe do elemento filho que você deseja obter.
Para procurar várias classes, separe-as com espaços, por exemplo, 'demo color'.

Detalhes Técnicos

Retorno:Retorna um objeto semelhante a um array de todos os elementos filhos que possuem todas as classes dadas.
Versão do DOM:Nível do DOM1

Referências Relacionadas

Tutorial do CSSSintaxe do CSS

Referência do CSSCSS .classSeletor

Referência do HTML DOMPropriedade className

Referência do HTML DOMPropriedade classList

Referência do HTML DOMdocument.getElementsByClassName()Método

Referência do HTML DOMelement.getElementsByTagName()Método

Objeto Elemento do HTML DOM