HTML DOM querySelector() 方法


HTML DOM querySelector() 方法

实例

获取文档中 id="demo" 的元素:

document.querySelector("#demo");

试一试 »

定义和用法

querySelector() 方法返回文档中匹配指定 CSS 选择器的一个元素。

注意: querySelector() 方法仅仅返回匹配指定选择器的第一个元素。如果你需要返回所有的元素,请使用 querySelectorAll() 方法替代。

浏览器支持

表格中的数字表示支持该方法的第一个浏览器的版本号。

方法
querySelector() 4.0 8.0 3.5 3.1 10.0

语法

document.querySelector( _CSS selectors_ )

参数值

参数 类型 描述
_CSS 选择器_ String 必须。指定一个或多个匹配元素的 CSS 选择器。 可以使用它们的 id, 类, 类型, 属性, 属性值等来选取元素。 对于多个选择器,使用逗号隔开,返回一个匹配的元素。 **提示:** 更多 CSS 选择器,请参阅我们的 [CSS 选择器参考手册](/cssref/css-selectors.html)。

技术细节

DOM 版本: Selectors Level 1 Document Object
返回值: 匹配指定 CSS 选择器的第一个元素。 如果没有找到,返回 null。如果指定了非法选择器则 抛出 SYNTAX_ERR 异常。

更多实例

实例

获取文档中第一个

元素:

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";

试一试 »