HTML DOM querySelector()メソッド

HTML 元素对象参考手册要素オブジェクト

例

class="demo" の <div> 要素の最初の子要素のテキスト内容を変更する:

var x = document.getElementById("myDIV"); x.querySelector(".demo").innerHTML = "Hello World!";

試してみる »

定義と用法

querySelector() メソッドは、指定された CSS セレクタに一致する要素の最初の子要素を返します。

注意:querySelector() メソッドは、指定されたセレクタに一致する最初の要素のみを返します。一致するすべての要素を返す場合は、代わりに querySelectorAll() メソッドを使用してください。

より多くの CSS セレクタについては、CSS セレクタチュートリアルとCSS セレクタリファレンスを参照してください。。


ブラウザサポート

表内の数字は、そのメソッドをサポートする最初のブラウザのバージョン番号を示します。

メソッド
querySelector() 4.0 8.0 3.5 3.1 10.0


構文

element.querySelector(CSS セレクタ)

パラメータ値

パラメータ 型 説明
CSS セレクタ String 必須。一致する要素を指定する 1 つ以上の CSS セレクタを指定します。id、クラス、型、属性、属性値などを使用して要素を選択できます。

複数のセレクタの場合は、カンマで区切って指定し、一致する要素を返します。

ヒント:より多くの CSS セレクタについては、次のドキュメントを参照してください:CSS セレクタリファレンス。

技術詳細

DOM バージョン: Selectors Level 1 Element Object
戻り値: 指定された CSS セレクタに一致する最初の要素。見つからない場合は null を返します。不正なセレクタが指定された場合は、SYNTAX_ERR 例外がスローされます。


その他の例

例

<div> 要素内の最初の <p> 要素の内容を変更する:

var x = document.getElementById("myDIV");
x.querySelector("p").innerHTML = "Hello World!";

試してみる »

例

<div> 要素内の最初の class="example" の子要素の内容を変更する:

var x = document.getElementById("myDIV");
x.querySelector(".example").innerHTML = "Hello World!";

試してみる »

例

<div> 要素内の最初の class="example" の <p> 要素を変更する:

var x = document.getElementById("myDIV");
x.querySelector("p.example").innerHTML = "Hello World!";

試してみる »

例

<div> 要素内で target 属性を持つ最初の <a> 要素に赤い枠線を追加する:

var x = document.getElementById("myDIV");
x.querySelector("a[target]").style.border = "10px solid red";

試してみる »

例

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

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

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

<div id="myDIV">
  <h2>A h2 element</h2>
  <h3>A h3 element</h3>
</div>

var x = document.getElementById("myDIV");
x.querySelector("h2, h3").style.backgroundColor = "red";

試してみる »

ただし、<div> 要素内で <h3> 要素が <h2> 要素より前に配置されている場合、<h3> 要素に指定された背景色が設定されます。

<div id="myDIV">
  <h3>A h3 element</h3>
  <h2>A h2 element</h2>
</div>

var x = document.getElementById("myDIV");
x.querySelector("h2, h3").style.backgroundColor = "red";

試してみる »


関連ページ

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


HTML 元素对象参考手册要素オブジェクト

その他の拡張