querySelector 用于根据 CSS 选择器获取第一个匹配元素,返回 null 而非报错;需判空避免错误;获取全部匹配项应使用 querySelectorAll;可在任意元素上调用实现局部查找。

querySelector 是 DOM API 中最常用的方法之一,用于根据 CSS 选择器获取**第一个匹配的元素**(只返回一个,即使有多个匹配项)。
基本用法:传入合法 CSS 选择器
语法很简单:document.querySelector(selector),其中 selector 是字符串,支持大多数标准 CSS 选择器:
-
document.querySelector('#header')→ 获取 id 为header的元素 -
document.querySelector('.btn-primary')→ 获取第一个 class 包含btn-primary的元素 -
document.querySelector('input[name="email"]')→ 获取第一个 name 属性等于email的 input 元素 -
document.querySelector('article h2')→ 获取第一个 article 内部的 h2 元素
注意返回值和找不到时的情况
如果没找到匹配元素,不会报错,而是返回 null。所以使用前建议判断:
使用 Husky 将 pre-commit、pre-push 和 commit-msg 检查集成到仓库中,以便代理和开发人员在更改离开工作站之前运行相同的本地防护措施。
const el = document.querySelector('.modal');-
if (el) { el.style.display = 'block'; }→ 避免Cannot read property 'style' of null
它只找“第一个”,不是全部
想获取所有匹配元素,请用 querySelectorAll(返回 NodeList)。例如:
-
document.querySelector('li')→ 只拿到第一个 -
document.querySelectorAll('li')→ 拿到所有,可遍历处理
也可以在某个元素内部查找
不限于 document,任意元素对象都可调用:
const container = document.querySelector('#list');-
const firstItem = container.querySelector('li');→ 在 #list 内找第一个 li
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










