blob: 91394ab0d6c6b1759bda520c83cbef81df168eb0 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
---
title: Document.getElementsByClassName()
slug: Web/API/Document/getElementsByClassName
tags:
- API
- DOM
- Gecko
- HTML5
- Métodos de Elementos DOM
- Referencia
- metodo
translation_of: Web/API/Document/getElementsByClassName
---
<p id="Summary">{{APIRef("DOM")}}</p>
<p>Retorna um vetor de objetos com todos os elementos filhos que possuem o nome da classe dada. Quando invocado no objeto <em>document</em>, o documento é examinado por completo, incluindo o nó raiz. Você também pode invocar {{domxref("Element.getElementsByClassName", "getElementsByClassName()")}} em qualquer elemento; isso retornaria somente elementos que são descendentes do nó raiz especificado com o nome da classe.</p>
<h2 id="Syntax" name="Syntax">Sintaxe</h2>
<pre class="syntaxbox"><var>var elementos</var> = document.getElementsByClassName(<em>nomes</em>); // ou:
<var>var elementos</var> = rootElement.getElementsByClassName(<em>nomes</em>);</pre>
<ul>
<li><var>elementos</var> é uma lista viva do {{ domxref("HTMLCollection") }} de elementos encontrados.</li>
<li><var>nomes</var> é um texto que representa uma lista dos nomes das classes que são separados por espaço em branco.</li>
<li>getElementsByClassName pode ser invocado por qualquer elemento, não somente pelo nó raiz <em>document. </em>O elemento no qual ele é chamado será usado como a raiz para a busca<em>.</em></li>
</ul>
<h2 id="Examples" name="Examples">Exemplos</h2>
<p>Retorna todos os elementos que possuem a classe 'teste'</p>
<pre class="brush: js">document.getElementsByClassName('teste');</pre>
<p>Retorna todos os elementos que possuem as classes 'vermelho' e 'teste'</p>
<pre class="brush: js">document.getElementsByClassName('vermelho teste');</pre>
<p>Retorna todos os elementos que possuem a classe 'teste' dentro do elemento que possui o ID 'principal'</p>
<pre class="brush: js">document.getElementById('principal').getElementsByClassName('teste');</pre>
<p>Nós podemos também usar os métodos do Array.prototype em qualquer dos elementos {{ domxref("HTMLCollection") }} passando o <var>HTMLCollection</var> como valor deste método. Aqui podemos encontrar todos os elementos do tipo <em>div</em> que possuem a classe 'teste':</p>
<pre class="brush: js">var elementosTeste = document.getElementsByClassName('teste');
var divsTeste = Array.prototype.filter.call(elementosTeste, function(elementoTeste) {
return elementoTeste.nodeName === 'DIV';
});</pre>
<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>Características</th>
<th>Chrome</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari</th>
</tr>
<tr>
<td>Suporte básico</td>
<td>{{ CompatVersionUnknown() }}</td>
<td>3.0</td>
<td>9.0</td>
<td>{{ CompatVersionUnknown() }}</td>
<td>{{ CompatVersionUnknown() }}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>Características</th>
<th>Android</th>
<th>Firefox Mobile (Gecko)</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
</tr>
<tr>
<td>Suporte básico</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatUnknown() }}</td>
<td>{{ CompatUnknown() }}</td>
</tr>
</tbody>
</table>
</div>
<h2 id="Specification" name="Specification">Especificação</h2>
<ul>
<li><a href="https://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-getelementsbyclassname" title="https://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#dom-document-getelementsbyclassname"><span class="external">W3C: getElementsByClassName</span></a></li>
</ul>
|
