浏览器与 Web API / 系统课时

使用 getElementById 查询元素

使用 getElementById 查询元素

getElementById 适合按唯一 ID 精确取得页面元素。本课将通过完整示例掌握它的返回值、未匹配时的空值处理,以及重复 ID 为什么会让查询结果变得不可预测。

学习目标

  • 使用 document.getElementById() 获取指定元素并修改内容。
  • 在操作元素前判断返回值是否为 null。
  • 理解 ID 在同一文档中必须保持唯一的原因。

查询规则与返回结果

document.getElementById(id) 接收一个不带 # 的 ID 字符串,并在当前文档中返回对应的元素对象。找到元素时,返回值可用于读取文本、属性和样式;没有匹配项时,返回 null,而不是空数组。

ID 查询是精确匹配,大小写也必须一致。例如元素写成 id="userName",查询参数就应使用 "userName"。写成 "#userName" 会把井号当作 ID 内容,因此无法匹配。

完整示例

下面的页面先查询状态文本和按钮,再在点击后修改状态。代码在使用元素前检查空值,因此即使后续有人误删节点,也不会直接触发属性访问错误。将代码保存为 index.html 并用浏览器打开。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>getElementById 示例</title>
</head>
<body>
  <p id="status">尚未开始</p>
  <button id="startButton" type="button">开始任务</button>

  <script>
    // 脚本位于目标节点之后,执行时元素已经完成解析。
    const statusElement = document.getElementById("status");
    const startButton = document.getElementById("startButton");

    // 只有两个节点都存在时才注册交互,避免对 null 访问属性。
    if (statusElement !== null && startButton !== null) {
      startButton.addEventListener("click", () => {
        statusElement.textContent = "任务已开始";
      });
    } else {
      console.error("页面缺少 status 或 startButton 元素");
    }
  </script>
</body>
</html>

预期结果

text
初始页面:尚未开始
点击按钮后:任务已开始

空值处理与唯一性

不要直接假设元素一定存在。脚本加载顺序改变、模板条件渲染或 ID 拼写错误,都可能让查询结果变成 null。推荐先判断,再读取属性或绑定事件;也可以在缺失时抛出明确错误,便于开发阶段快速定位。

同一文档中的 ID 应保持唯一。浏览器遇到重复 ID 时,getElementById 通常只返回其中一个元素,但具体命中哪个节点不应成为程序逻辑的一部分。需要处理一组元素时,应改用类选择器配合 querySelectorAll。

常见错误

  • 把参数写成 "#status",导致查询失败。
  • 在元素创建之前执行脚本,又没有使用 defer 或把脚本放到页面末尾。
  • 未判断 null 就访问 textContent、classList 或 addEventListener。
  • 在多个元素上复用同一个 ID,造成样式、表单标签和脚本行为混乱。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 getElementById 查询元素

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

登录哪都通