blob: 12c10525d5acee0414305669860554b78ab650e5 (
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
|
---
title: Element.querySelector()
slug: Web/API/Element/querySelector
translation_of: Web/API/Element/querySelector
---
<div>{{APIRef}}</div>
<p>対象要素の子孫の内、引数に指定したCSSセレクタにマッチする最初の要素を返します。</p>
<h2 id="Syntax" name="Syntax">構文</h2>
<pre class="syntaxbox"><var>element</var> = baseElement.querySelector(<em>selector</em>s);
</pre>
<ul>
<li><code>element</code>と<code>baseElement</code>は{{domxref("element")}}オブジェクトを表します。</li>
<li><code>selectors</code>はマッチさせたい1つ以上の<a href="/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors">セレクタ</a>を表します。</li>
</ul>
<h2 id="Example" name="Example">例</h2>
<p>次の例では、type属性を持たないか､<span style="font-family: Consolas, Monaco, 'Andale Mono', monospace;"><code>text/css</code>を<code>type</code>属性として持つ、ドキュメントボディーの中で</span>最初の<code style="font-style: normal;">style</code>要素が返却されます。</p>
<pre class="brush:js">var el = document.body.querySelector("style[type='text/css'], style:not([type])");
</pre>
<h2 id="Notes" name="Notes">注記</h2>
<p>マッチする要素が無い場合は<code>nullを返します</code>。その他の場合は､最初にマッチした要素を返します。</p>
<p>指定されたセレクタが不正である場合、例外「<code>SYNTAX_ERR</code>」がスローされます。</p>
<p>Throws a <code>SYNTAX_ERR</code> exception if the specified group of selectors is invalid.</p>
<p><span style="font-family: Courier New;"><span>querySelector()</span></span>はWebApps API仕様で定義されました。</p>
<p><code>querySelector</code>に渡す文字列はCSSの文法に則る必要があります。{{domxref("document.querySelector")}}で実例を見て下さい。</p>
<h2 id="ブラウザ実装状況">ブラウザ実装状況</h2>
<table class="standard-table">
<tbody>
<tr>
<th>Browser</th>
<th>Support</th>
<th>Notes</th>
</tr>
<tr>
<td>Internet Explorer</td>
<td>8</td>
<td>CSS 2.1 selectors only (IE8)</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">仕様書</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">関連情報</h2>
<ul>
<li><a dir="ltr" href="/ja/docs/DOM/Element.querySelectorAll"><code>element.querySelectorAll</code></a></li>
<li><a href="/ja/docs/DOM/Document.querySelector"><code>document.querySelector</code></a></li>
<li><a href="/ja/docs/DOM/Document.querySelectorAll"><code>document.querySelectorAll</code></a></li>
<li><a href="/ja/docs/Code_snippets/QuerySelector">querySelectorのコードスニペット</a></li>
</ul>
|
