Element.querySelector()

by 2 contributors:

対象要素の子孫の内、引数に指定したCSSセレクタにマッチする最初の要素を返します。

構文

element = baseElement.querySelector(selectors);
  • elementbaseElementelementオブジェクトを表します。
  • selectorsはマッチさせたい1つ以上のセレクタを表します。

次の例では、type属性を持たないか、text/csstype属性として持つ、ドキュメントボディーの中で最初のstyle要素が返却されます。

var el = document.body.querySelector("style[type='text/css'], style:not([type])");

注記

マッチする要素が無い場合はnullを返します。その他の場合は、最初にマッチした要素を返します。

指定されたセレクタが不正である場合、例外「SYNTAX_ERR」がスローされます。

Throws a SYNTAX_ERR exception if the specified group of selectors is invalid.

querySelector()はWebApps API仕様で定義されました。

querySelectorに渡す文字列はCSSの文法に則る必要があります。document.querySelectorで実例を見て下さい。

ブラウザ実装状況

Browser Support Notes
Internet Explorer 8 CSS 2.1 selectors only (IE8)
Firefox (Gecko) 3.5 (1.9.1)  
Opera 10  
Chrome 1  
Safari (webkit) 3.2 (525.3) webk.it/16587

仕様書

関連情報

ドキュメントのタグと貢献者

Contributors to this page: fscholz, yanana
最終更新者: yanana,