浏览器与 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。
  • 选择器范围过宽,意外命中页面中更靠前的同类元素。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 querySelector 查询元素

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通