対象要素の子孫の内、引数に指定したCSSセレクタにマッチする最初の要素を返します。
構文
element = baseElement.querySelector(selectors);
例
次の例では、type属性を持たないか､text/cssをtype属性として持つ、ドキュメントボディーの中で最初の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 |