HTML DOM querySelector()メソッド
定義と用法
querySelector() メソッドは、ドキュメント内で指定した CSS セレクタに一致する要素を返します。
注意:querySelector() メソッドは、指定したセレクタに一致する最初の要素のみを返します。すべての要素を返す必要がある場合は、代わりに querySelectorAll() メソッドを使用してください。
その他の CSS セレクタについては、当サイトのCSS セレクタチュートリアルおよびCSS セレクタリファレンス。
ブラウザサポート
表内の数字は、そのメソッドをサポートした最初のブラウザのバージョン番号を示します。
| メソッド | |||||
|---|---|---|---|---|---|
| querySelector() | 4.0 | 8.0 | 3.5 | 3.1 | 10.0 |
構文
document.querySelector(CSS selectors)
パラメータ値
| パラメータ | 型 | 説明 |
|---|---|---|
| CSS セレクタ | String | 必須。一致する要素を指定する 1 つ以上の CSS セレクタを指定します。id、クラス、タイプ、属性、属性値などを使用して要素を選択できます。 複数のセレクタの場合はカンマで区切り、一致する要素を返します。 ヒント:その他の CSS セレクタについては、当サイトのCSS セレクタリファレンス。 |
技術的な詳細
| DOM バージョン: | Selectors Level 1 Document Object |
|---|---|
| 戻り値: | 指定した CSS セレクタに一致する最初の要素。見つからない場合は null を返します。不正なセレクタを指定した場合は SYNTAX_ERR 例外がスローされます。 |
その他の例
例
次の例は、複数のセレクタの使用方法を示しています。
2 つのセレクタを選択したと仮定します: <h2> 要素と <h3> 要素。
次のコードは、ドキュメントの最初の <h2> 要素に背景色を追加します:
<h2>A h2 element</h2>
<h3>A h3 element</h3>
document.querySelector("h2, h3").style.backgroundColor = "red";
<h3>A h3 element</h3>
document.querySelector("h2, h3").style.backgroundColor = "red";
試してみる »
ただし、ドキュメント内で <h3> 要素が <h2> 要素より前に存在する場合、<h3> 要素に指定された背景色が設定されます。
<h3>A h3 element</h3>
<h2>A h2 element</h2>
document.querySelector("h2, h3").style.backgroundColor = "red";
<h2>A h2 element</h2>
document.querySelector("h2, h3").style.backgroundColor = "red";
試してみる »
関連ページ
JavaScript リファレンス:element.querySelector()
その他の拡張
Document オブジェクト