aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/api/document/getelementsbyclassname/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/pt-br/web/api/document/getelementsbyclassname/index.html')
-rw-r--r--files/pt-br/web/api/document/getelementsbyclassname/index.html104
1 files changed, 104 insertions, 0 deletions
diff --git a/files/pt-br/web/api/document/getelementsbyclassname/index.html b/files/pt-br/web/api/document/getelementsbyclassname/index.html
new file mode 100644
index 0000000000..44fa28f840
--- /dev/null
+++ b/files/pt-br/web/api/document/getelementsbyclassname/index.html
@@ -0,0 +1,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="Compatibilidade_com_navegadores">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>