HTML DOM querySelector() 方法
document.querySelector() 方法返回文档中匹配指定 CSS 选择器的一个元素
document.querySelector() 方法仅仅返回匹配指定选择器的第一个元素
如果需要返回所有的元素,请使用 document.querySelectorAll() 方法替代
更多 CSS 选择器,请访问我们的 CSS 选择器参考手册
浏览器支持
Yes | 8.0+ | Yes | Yes | Yes |
语法
document.querySelector( "CSS selectors" )
参数值
参数 | 类型 | 描述 |
---|---|---|
CSS 选择器 | String | 必须。指定一个或多个匹配元素的 CSS 选择器 可以使用它们的 id, 类, 类型, 属性, 属性值等来选取元素 对于多个选择器,使用逗号隔开,返回一个匹配的元素 |
返回值
匹配指定 CSS 选择器的第一个元素
如果没有找到,返回 null
如果指定了非法选择器则抛出 SYNTAX_ERR 异常
范例
获取文档中 id="demo" 的元素
document.querySelector("#demo");
范例
获取文档中第一个 <p> 元素
document.querySelector("p");
获取文档中 class="example" 的第一个元素
document.querySelector(".example");
范例
获取文档中 class="example" 的第一个 <p> 元素
document.querySelector("p.example");
范例
获取文档中有 "target" 属性的第一个 <a> 元素
document.querySelector("a[target]");
范例
为文档的第一个 <h2> 元素添加背景颜色
<h2>A h2 element</h2> <h3>A h3 element</h3> <script> document.querySelector("h2, h3").style.backgroundColor = "red"; </script>
但是,如果文档中 <h3> 元素位于 <h2> 元素之前,<h3> 元素将会被设置指定的背景颜色
<h3>A h3 element</h3> <h2>A h2 element</h2> <script> document.querySelector("h2, h3").style.backgroundColor = "red"; </script>
相关页面
JavaScript 参考手册: element .querySelector()