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 必须。指定一个或多个匹配元素的 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]");

尝试一下 »

实例

以下实例演示了多个选择器的使用方法。

假定你选择了两个选择器： <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 对象