blob: cbd41e09fffb3ee5fe6b483433f3d7864d88bdfd (
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
|
---
title: Element.querySelector()
slug: Web/API/Element/querySelector
tags:
- API
- DOM
- Elemento
- Referencia
translation_of: Web/API/Element/querySelector
---
<div>{{APIRef("DOM")}}</div>
<p>Retorna o primeiro elemento descendente do elemento em que a função foi invocada e que corresponde aos seletores especificado. </p>
<h2 id="Syntax" name="Syntax">Sintaxe</h2>
<pre class="syntaxbox"><var>elemento</var> = elementoBase.querySelector(seletores);
</pre>
<ul>
<li><code>elemento</code> e<code> elementoBase</code> são objetos {{domxref("element")}}.</li>
<li><code>selectores</code> é um grupo de <a href="/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors">selectores</a>.</li>
</ul>
<h2 id="Example" name="Example">Exemplo</h2>
<p>Neste exemplo é retornado o primeiro elemento <code>style</code> que, ou não tem nenhum atributo type, ou tem o atributo type igual a <code>text/css</code>:</p>
<pre class="brush:js">var el = document.body.querySelector("style[type='text/css'], style:not([type])");
</pre>
<h2 id="Notes" name="Notes">Notas</h2>
<p>Retorna <code>null </code>se nenhum elemento for encontrado; caso contrário retorna o primeiro elemento; </p>
<p>Lança uma exceção <code>SYNTAX_ERR</code> se o grupo de seletores é inválido.</p>
<p><span style="font-family: courier new;"><span>querySelector()</span></span> foi introduzido em WebApps API.</p>
<p>O argumento de string do <code>querySelector</code> deve seguir a sintaxe CSS. Veja exemplos concretos em {{domxref("document.querySelector")}}</p>
<h2 id="Compatibilidade_de_Browsers">Compatibilidade de Browsers</h2>
<table class="standard-table">
<tbody>
<tr>
<th>Browser</th>
<th>Suporte</th>
<th>Notas</th>
</tr>
<tr>
<td>Internet Explorer</td>
<td>8</td>
<td>(IE8) apenas selectores CSS 2.1</td>
</tr>
<tr>
<td>Firefox (Gecko)</td>
<td><strong>3.5</strong> (1.9.1)</td>
<td> </td>
</tr>
<tr>
<td>Opera</td>
<td>10</td>
<td> </td>
</tr>
<tr>
<td>Chrome</td>
<td>1</td>
<td> </td>
</tr>
<tr>
<td>Safari (webkit)</td>
<td>3.2 (525.3)</td>
<td><a class="link-https" href="https://bugs.webkit.org/show_bug.cgi?id=16587">webk.it/16587</a></td>
</tr>
</tbody>
</table>
<h2 id="Specification" name="Specification">Especificação</h2>
<ul>
<li>{{spec("http://www.w3.org/TR/selectors-api/","Selectors API Level 1","rec")}}</li>
<li>{{spec("http://www.w3.org/TR/selectors-api2/","Selectors API Level 2","wd")}}</li>
<li>{{spec("http://dev.w3.org/2006/webapi/selectors-api2/","Selectors API Level 2","ed")}}</li>
</ul>
<h2 id="See_also" name="See_also">Veja Também</h2>
<ul>
<li><a href="/en-US/docs/DOM/Element.querySelectorAll"><code>element.querySelectorAll</code></a></li>
<li><a href="/en-US/docs/DOM/Document.querySelector"><code>document.querySelector</code></a></li>
<li><a href="/en-US/docs/DOM/Document.querySelectorAll"><code>document.querySelectorAll</code></a></li>
<li><a href="/en-US/docs/Code_snippets/QuerySelector">Code snippets for querySelector</a></li>
</ul>
|
