English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
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.
element.getElementsByClassName(class)
var gBox = document.getElementById("greenBox"); gBox.getElementsByClassName("demo")[0].innerHTML = "Hello World";Teste e veja‹/›
O método getElementsByClassName() é completamente suportado por todos os navegadores:
Método | |||||
getElementsByClassName() | Sim | Sim | Sim | Sim | Sim |
Parâmetro | Descrição |
---|---|
class | O nome da classe do elemento filho que você deseja obter. Para procurar várias classes, separe-as com espaços, por exemplo, 'demo color'. |
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 |
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