HTML DOM querySelector()メソッド

Document 对象参考手册Document オブジェクト

例

ドキュメント内の id="demo" の要素を取得する:

document.querySelector("#demo");

試してみる »

定義と用法

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 例外がスローされます。


その他の例

例

ドキュメント内の最初の <p> 要素を取得する:

document.querySelector("p");

試してみる »

例

ドキュメント内の class="example" の最初の要素を取得する:

document.querySelector(".example");

試してみる »

例

ドキュメント内の class="example" の最初の <p> 要素を取得する:

document.querySelector("p.example");

試してみる »

例

ドキュメント内で "target" 属性を持つ最初の <a> 要素を取得する:

document.querySelector("a[target]");

試してみる »

例

次の例は、複数のセレクタの使用方法を示しています。

2 つのセレクタを選択したと仮定します: <h2> 要素と <h3> 要素。

次のコードは、ドキュメントの最初の <h2> 要素に背景色を追加します:

<h2>A h2 element</h2>
<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";

試してみる »


関連ページ

JavaScript リファレンス:element.querySelector()


Document 对象参考手册Document オブジェクト

その他の拡張