> JavaScript中文手册 > element.querySelector()

实例

修改 id="demo" 的 <div>元素的第一个子元素文本内容:

var x = document.getElementById("myDIV");
x.querySelector("#demo").innerHTML = "Hello World!";
运行一下 »

定义与用法

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

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

对于更多的 CSS 选择,可以访问我们的 CSS 选择器教程 和我们的 CSS 选择器参考手册 。

浏览器支持

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

方法




querySelector() 4.0 8.0 3.5 3.1 10.0

语法

element.querySelector(CSS 选择器)

参数值

参数 类型 描述
CSS 选择器 String 必须。指定一个或多个匹配元素的 CSS 选择器。 可以使用它们的 id, 类, 类型, 属性, 属性值等来选取元素。

对于多个选择器,使用逗号隔开,返回一个匹配的元素。

提示: 更多 CSS 选择器,请参阅我们的 CSS 选择器参考手册。

技术细节

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

更多实例

实例

修改 <div> 元素中的第一个 <p> 元素内容:

var x = document.getElementById("myDIV");
x.querySelector("p").innerHTML = "Hello World!";
运行一下 »

实例

修改 <div> 元素中第一个 class="example" 的子元素内容:

var x = document.getElementById("myDIV");
x.querySelector(".example").innerHTML = "Hello World!";
运行一下 »

实例

修改 <div> 元素中第一个 class="example" 的 <p> 元素:

var x = document.getElementById("myDIV");
x.querySelector("p.example").innerHTML = "Hello World!";
运行一下 »

实例

为 <div> 元素中的第一个有 target 属性的 <a> 元素添加红色边框:

var x = document.getElementById("myDIV");
x.querySelector("a[target]").style.border = "10px solid red";
运行一下 »

实例

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

假定你选择了两个选择器: <h2> 和 <h3> 元素。

以下代码将为 <div> 元素的第一个 <h2> 元素添加背景颜色:

<div id="myDIV">
  <h2>A h2 element</h2>
  <h3>A h3 element</h3>
</div>

var x = document.getElementById("myDIV");
x.querySelector("h2, h3").style.backgroundColor = "red";
运行一下 »

但是,如果 <div> 元素中 <h3> 元素位于 <h2> 元素之前,<h3> 元素将会被设置指定的背景颜色。

<div id="myDIV">
  <h3>A h3 element</h3>
  <h2>A h2 element</h2>
</div>

var x = document.getElementById("myDIV");
x.querySelector("h2, h3").style.backgroundColor = "red";
运行一下 »