浏览器与 Web API / 系统课时
使用 querySelector 查询元素
使用 querySelector 查询元素
querySelector 可以复用 CSS 选择器语法查询单个元素。本课将用一个完整页面演示标签、类、属性和组合选择器,并建立未匹配时先处理 null 的安全操作习惯。
学习目标
- 使用常见 CSS 选择器查询第一个匹配元素。
- 理解组合选择器如何缩小查询范围。
- 正确处理没有匹配节点时返回的
null。
接口规则
document.querySelector(selector) 接收合法的 CSS 选择器字符串,并返回文档中第一个匹配元素。没有匹配项时返回 null;选择器语法无效时则会抛出 SyntaxError,两种失败方式需要区分。
标签选择器写作 "button",类选择器写作 ".notice",属性选择器可写作 "[data-role='save']"。组合选择器能够表达范围和关系,例如 ".toolbar button[data-action='save']" 只匹配工具栏内具有指定属性的按钮。
完整示例
下面的页面分别使用标签、类、属性和组合选择器查询节点。保存按钮点击后,组合选择器定位到的状态文本会更新,同时在控制台输出其他查询结果。将代码保存为 index.html 后用浏览器打开,并打开开发者工具。
html
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>querySelector 示例</title>
</head>
<body>
<section class="panel" data-module="profile">
<h2 class="panel-title">个人资料</h2>
<p class="status" data-state="idle">等待保存</p>
<div class="toolbar">
<button type="button" data-action="save">保存</button>
</div>
</section>
<script>
// 四个变量依次演示标签、类、属性和组合选择器。
const firstButton = document.querySelector("button");
const title = document.querySelector(".panel-title");
const idleStatus = document.querySelector("[data-state='idle']");
const saveButton = document.querySelector(
".panel .toolbar button[data-action='save']"
);
// 查询结果可能为 null,因此先确认关键节点存在。
if (idleStatus !== null && saveButton !== null) {
saveButton.addEventListener("click", () => {
idleStatus.textContent = "保存完成";
idleStatus.setAttribute("data-state", "saved");
});
}
console.log(firstButton?.textContent);
console.log(title?.textContent);
</script>
</body>
</html>预期输出
text
控制台:
保存
个人资料
页面点击前:等待保存
页面点击后:保存完成选择器边界与空值处理
querySelector 只返回第一个匹配元素。页面中有多个同类节点且需要全部处理时,应使用 querySelectorAll。为了减少误匹配,优先从稳定容器开始组合选择器,而不是依赖过长的标签层级。
未匹配时可以使用显式判断,也可以在只读场景使用可选链,例如 title?.textContent。但绑定事件或执行关键更新时,显式判断通常更清楚,因为它能决定是跳过操作、记录错误,还是中止初始化。
动态拼接选择器时要特别谨慎。用户输入可能包含引号、括号等特殊字符,从而生成无效选择器。查询动态 ID 时,可使用 CSS.escape() 转义值,再拼成安全选择器。
常见错误
- 类选择器漏写
.,把类名误当成标签名。 - 属性值引号不配对,导致
SyntaxError。 - 误以为接口会返回数组,直接访问索引或调用
forEach。 - 选择器范围过宽,意外命中页面中更靠前的同类元素。
按自己的节奏,确认真正理解。