HTML DOM querySelector() 方法

HTML DOM querySelector() 方法

 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()