files/pt-br/web/api/element/queryselectorall/index.html


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
105
106
107
108
109
110
111
112
113
114
115
116
117
118

---
title: Element.querySelectorAll()
slug: Web/API/Element/querySelectorAll
translation_of: Web/API/Element/querySelectorAll
---
<div>{{APIRef("DOM")}}</div>

<h2 id="Summary" name="Summary">Sumário</h2>

<p>Retorna uma <span style="line-height: 1.5;"> </span><a href="/en-US/docs/DOM/NodeList" style="line-height: 1.5;" title="DOM/NodeList"><code>NodeList</code></a><span style="line-height: 1.5;"> de todos os elementos descendentes do elemento que foi invocado que sejam compatíveis com o grupo de seletores CSS especificados.</span></p>

<h2 id="Syntax" name="Syntax">Sintaxe</h2>

<pre class="syntaxbox"><em>elementList</em> = baseElement.querySelectorAll(<em>selectors</em>);
</pre>

<p>Onde</p>

<ul>
 <li><code>elementList</code> é uma lista não-viva de objetos <a href="/en-US/docs/DOM/element" title="DOM/Element">element</a>.</li>
 <li><code>baseElement</code> é um objeto <a href="/en-US/docs/DOM/element" title="DOM/element">elemento</a>.</li>
 <li><code>selectors</code> é um grupo de <a href="/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors">seletores</a> que serão procurados.</li>
</ul>

<h2 id="Example" name="Example">Exemplos</h2>

<p>Este exemplo retorna uma lista de todos os elementos <code>p</code> no corpo do HTML:</p>

<pre class="brush: js">var matches = document.body.querySelectorAll('p');
</pre>

<p><span style="line-height: 1.5;">Este exemplo retorna uma lista de elementos </span><code style="font-style: normal; line-height: 1.5;">p</code><span style="line-height: 1.5;"> que estejam contidos em outro elemento, o qual é uma </span><code style="font-style: normal; line-height: 1.5;">div</code><span style="line-height: 1.5;"> que tem a classe 'highlighted':</span></p>

<p> </p>

<pre class="brush:js">var el = document.querySelector('#test');
var matches = el.querySelectorAll('div.highlighted &gt; p'); </pre>

<p>Este exemplo retorna uma lista de elementos <code>iframe</code> que contenham um atributo <strong>data</strong> 'src':</p>

<pre class="brush: js">var matches = el.querySelectorAll('iframe[data-src]');
</pre>

<h2 id="Notes" name="Notes">Notas</h2>

<p>Joga uma excessão <code>SYNTAX_ERR</code> se o grupo especificado de seletores for inválido.</p>

<p><code>querySelectorAll()</code> foi introduzida na WebApps API.</p>

<p>A <em>string</em> passada como argumento para <span style="font-family: 'Courier New','Andale Mono',monospace; line-height: 1.5;">querySelectorAll<code> </code></span>deve seguir a sintaxe do CSS. veja {{domxref("document.querySelector")}} para um exemplo concreto.</p>

<p>Lembre-se que o valor retornado é uma NodeList, então não é recomendado o uso de recursões for...in, nem de nenhum método de <em>array</em>. Se realmente houver a necessidade de usar métodos de uma <em>array,</em> então o NodeList deve ser convertido em uma <em>array </em>antes de ser usado.</p>

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Suporte básico</td>
   <td>1</td>
   <td>{{CompatGeckoDesktop("1.9.1")}}</td>
   <td>8</td>
   <td>10</td>
   <td>3.2 (525.3)</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Suporte básico</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoMobile("1.9.1")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="Specification" name="Specification"> </h2>

<h2 id="Specification" name="Specification">Especificações</h2>

<ul>
 <li><a href="http://www.w3.org/TR/selectors-api/" title="http://www.w3.org/TR/selectors-api/">Selectors API</a></li>
</ul>

<h2 id="See_also" name="See_also">Veja também</h2>

<ul>
 <li><a href="/en-US/docs/DOM/Document.querySelectorAll" title="DOM/document.querySelectorAll"><code>document.querySelectorAll</code></a></li>
 <li><a href="/en-US/docs/DOM/Document.querySelector" title="DOM/document.querySelector"><code>document.querySelector</code></a></li>
 <li><a href="/en-US/docs/Code_snippets/QuerySelector" title="Code_snippets/QuerySelector">Code snippets for <code>querySelector</code></a></li>
</ul>