diff options
Diffstat (limited to 'files/pt-pt/web/api/document/getelementsbyclassname/index.html')
-rw-r--r-- | files/pt-pt/web/api/document/getelementsbyclassname/index.html | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/files/pt-pt/web/api/document/getelementsbyclassname/index.html b/files/pt-pt/web/api/document/getelementsbyclassname/index.html new file mode 100644 index 0000000000..3ce79ed564 --- /dev/null +++ b/files/pt-pt/web/api/document/getelementsbyclassname/index.html @@ -0,0 +1,69 @@ +--- +title: document.getElementsByClassName +slug: DOM/document.getElementsByClassName +tags: + - Referência_do_DOM_Gecko +translation_of: Web/API/Document/getElementsByClassName +--- +<p>{{ Fx_minversion_header(3) }} {{ ApiRef() }}</p> + +<h3 id="Resumo" name="Resumo">Resumo</h3> + +<p>Retorna um conjunto de elementos com o nome de classe fornecido. Quando chamado no objeto document, todo o documento é pesquisado incluindo o nó raiz. Você pode chamar também getElementsByClassName em qualquer elemento; isso retornará apenas elementos sob o elemento raiz especificado com o nome de classe fornecido.</p> + +<h3 id="Sintaxe" name="Sintaxe">Sintaxe</h3> + +<pre class="eval"><em>elementos</em> = document.getElementsByClassName(<em>nome</em>) // ou:<em>elementos</em> = elementoRaiz.getElementsByClassName(<em>nome</em>) +</pre> + +<ul> + <li><code>elementos</code> é um <code>NodeList</code> vivo de elementos encontrados na ordem que aparecem na árvore.</li> + <li><code>nome</code> é uma<em>string</em> representando um nome de classe dos elementos.</li> + <li><code>getElementsByClassName</code> pode ser chamado em qualquer elemento, não apenas no <code>document</code>. O elemento em que é chamado será usado como a raiz da pesquisa.</li> +</ul> + +<h3 id="Exemplos" name="Exemplos">Exemplos</h3> + +<p>Devolve todos os elementos que têm a classe 'teste':</p> + +<pre class="eval"> document.getElementsByClassName('teste') +</pre> + +<p>Devolve todos os elementos que têm as classes 'vermelho' e 'teste':</p> + +<pre class="eval"> document.getElementsByClassName('vermelho teste') +</pre> + +<p>Devolve todos os elementos que têm a classe 'teste', dentro de um elemento que tem o ID 'principal':</p> + +<pre class="eval"> document.getElementById('principal').getElementsByClassName('teste') +</pre> + +<p>E se formos adiante e adicionarmos extras do Array do <a href="pt/New_in_JavaScript_1.6">JavaScript 1.6</a>, podemos fazer algumas combinações realmente boas.</p> + +<p>Encontre todos os elementos div que têm a classe 'teste'</p> + +<pre class="eval"> Array.filter( document.getElementsByClassName('teste'), function(elem){ + return elem.nodeName == 'DIV'; + }); +</pre> + +<p>Encontre todos os elementos que têm a classe 'teste' (como faz seu elemento pai)</p> + +<pre class="eval"> var teste = document.getElementsByClassName('teste'); + Array.filter( teste, function(elem){ + return Array.indexOf( teste, elem.parentNode ) > -1; + }); +</pre> + +<p><span class="comment">XXX escreva-me == Notas == Um método similar existe em <code>Element</code></span></p> + +<h3 id="Especifica.C3.A7.C3.A3o" name="Especifica.C3.A7.C3.A3o">Especificação</h3> + +<p><a class="external" href="http://whatwg.org/specs/web-apps/current-work/#getelementsbyclassname">WHATWG Web Applications 1.0: getElementsByClassName</a></p> + +<p><span class="comment">Categorias</span></p> + +<p><span class="comment">Interwiki Language Links</span></p> + +<p>{{ languages( { "en": "en/DOM/document.getElementsByClassName", "fr": "fr/DOM/document.getElementsByClassName" } ) }}</p> |