轻松上手,快乐学习!

HTML DOM querySelector() 方法


实例

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

var x = document.getElementById("myDIV");
x.querySelector(".example").innerHTML = "Hello World!";
亲自试一试 »

页面下方有更多实例。


定义和用法

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

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

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


浏览器支持

表中的数字指定了完全支持该方法的第一个浏览器版本。

方法
querySelector() 4.0 8.0 3.5 3.2 10.0

语法

element.querySelector(CSS selectors)

参数值

参数 类型 描述
CSS selectors 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" 的 <p> 元素:

var x = document.getElementById("myDIV");
x.querySelector("p.example").innerHTML = "Hello World!";
亲自试一试 »

实例

在 <div> 元素中更改 id="demo" 元素的文本:

var x = document.getElementById("myDIV");
x.querySelector("#demo").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";
亲自试一试 »

相关页面

CSS 教程: CSS 选择器

CSS 参考手册: CSS 选择器参考手册

JavaScript 教程: JavaScript HTML DOM Node List

JavaScript 参考手册: document.querySelector()

JavaScript 参考手册: element.querySelectorAll()

HTML DOM 参考手册: document.querySelectorAll()