diff options
Diffstat (limited to 'files/pt-br/web/api/document/queryselectorall/index.html')
-rw-r--r-- | files/pt-br/web/api/document/queryselectorall/index.html | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/files/pt-br/web/api/document/queryselectorall/index.html b/files/pt-br/web/api/document/queryselectorall/index.html new file mode 100644 index 0000000000..0a05a06180 --- /dev/null +++ b/files/pt-br/web/api/document/queryselectorall/index.html @@ -0,0 +1,110 @@ +--- +title: Document.querySelectorAll() +slug: Web/API/Document/querySelectorAll +tags: + - CSS + - JavaScript + - querySelector +translation_of: Web/API/Document/querySelectorAll +--- +<p id="Summary">{{ ApiRef("DOM") }}</p> + +<h2 id="Summary" name="Summary">Introdução</h2> + +<p>Retorna uma lista de elementos presentes no documento (usando ordenação em profundidade, pré-ordenada e transversal dos nós do documento) que coincidam com o grupo de seletores especificado. O objeto retornado é uma {{ domxref("NodeList") }}.</p> + +<h2 id="Syntax" name="Syntax">Sintaxe</h2> + +<pre class="eval"><em>elementList</em> = document.querySelectorAll(selectors); +</pre> + +<p>onde</p> + +<ul> + <li><code>elementList</code> é uma {{ domxref("NodeList") }} não-viva (alterações no DOM não refletem na lista) de objetos {{ domxref("Element") }}.</li> + <li><code>selectors</code> é uma <em>string</em> contendo um ou mais seletores CSS separados por vírgulas.</li> +</ul> + +<p>A NodeList retornada irá conter todos os elementos do documento que coincidam com os seletores especificados. Se a string <code><em>selectors</em></code> conter um CSS {{ cssxref("PseudoElements") }}, o retorno será uma NodeList vazia.</p> + +<h2 id="Example" name="Example">Exemplo</h2> + +<p>Esse exemplo retorna uma lista de todos os elementos <code>div</code> presentes no <code>document</code> que contenham as classes "<code>note</code>" ou "<code>alert</code>":</p> + +<pre class="brush: js">var matches = document.querySelectorAll("div.note, div.alert"); +</pre> + +<h2 id="Notes" name="Notes">Notas</h2> + +<p>Retorna uma {{ jsxref("NodeList") }} não-viva (alterações no DOM não refletem na lista) de todos os elementos que coincidam com os seletores informados.</p> + +<p>Lança uma exceçã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>Navegadores baseados em <em>WebKit</em> têm um <em>bug</em>: quando a string <code><em>seletores</em></code> contém um <a href="/en-US/docs/CSS/Pseudo-elements" title="/en-US/docs/CSS/Pseudo-elements">pseudo-elemento CSS</a>, a {{ jsxref("NodeList") }} retornada não esta vazia, neste caso ela contém o elemento {{ HTMLElement("html") }}.</p> + +<h2 id="Compatibilidade_nos_navegadores">Compatibilidade nos navegadores</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Possui</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>3.5 (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>Possui</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>2.1</td> + <td>sim</td> + <td>9</td> + <td>10.0</td> + <td>3.2</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Specification" name="Specification">Especificação</h2> + +<ul> + <li><a href="http://www.w3.org/TR/selectors-api/" title="http://www.w3.org/TR/selectors-api/">API Selectors</a></li> +</ul> + +<h2 id="See_also" name="See_also">Veja também</h2> + +<ul> + <li>{{ domxref("Element.querySelectorAll") }}</li> + <li>{{ domxref("Document.querySelector") }}</li> + <li>{{ domxref("Element.querySelector") }}</li> + <li><code><a href="/pt-BR/docs/Code_snippets/QuerySelector" title="en-US/docs/Code_snippets/QuerySelector">Exemplos de código com querySelector</a></code></li> +</ul> |