JavaScript / TypeScript / 系统课时

查询页面元素

查询页面元素

当页面需要根据用户操作、数据变化动态更新内容时,第一步是准确找到目标元素。本篇将学习 JavaScript 中常用的元素查询方法,理解不同选择器的匹配规则,并能够在实际页面脚本中定位需要操作的节点。

学习目标

  • 掌握 querySelector 和 querySelectorAll 的基本用法。
  • 理解 CSS 选择器在 DOM 查询中的作用。
  • 能根据页面结构选择合适的元素查询方式。

使用 querySelector 查询单个元素

querySelector 会接收一个 CSS 选择器字符串,并返回匹配到的第一个元素。如果页面中存在多个符合条件的节点,它只返回第一个结果。

例如,一个页面中有多个按钮,但只需要操作第一个主要按钮时,可以使用这种方式:

html
<button class="action">保存</button>
<button class="action">取消</button>
js
const button = document.querySelector('.action');

button.textContent = '提交';

预期结果

text
页面中第一个 class 为 action 的按钮文字变为“提交”。

querySelector 支持常见 CSS 选择器,包括标签选择器、类选择器、ID 选择器和属性选择器。

常见写法如下:

选择器 示例 匹配内容
标签 div 所有 div 元素中的第一个
类名 .item class 包含 item 的元素
ID #header id 为 header 的元素
属性 [data-id] 存在指定属性的元素

使用 querySelectorAll 查询多个元素

当页面需要批量处理多个元素时,应使用 querySelectorAll。它会返回所有匹配元素组成的 NodeList。

例如,为列表中的所有按钮添加点击事件:

js
const buttons = document.querySelectorAll('.action');

buttons.forEach((button) => {
  button.addEventListener('click', () => {
    console.log(button.textContent);
  });
});

预期输出

text
点击任意 action 按钮后,控制台输出对应按钮文字。

与数组类似,NodeList 支持 forEach 遍历,但它并不是普通数组。如果需要使用数组方法,可以转换:

js
const elements = Array.from(document.querySelectorAll('.action'));

根据页面结构选择查询方式

实际开发中,选择查询方式的关键不是记住 API,而是根据操作目标判断范围。

如果目标唯一,例如页面标题、登录区域,可以优先使用 ID 或精确选择器:

js
const title = document.querySelector('#page-title');

如果需要处理一组相同组件,例如商品卡片、菜单项,则使用 querySelectorAll:

js
const cards = document.querySelectorAll('.product-card');

选择器越精确,代码越不容易因为页面结构变化而误操作。

查询元素时的常见问题

如果选择器没有匹配任何元素,querySelector 会返回 null,继续访问属性会导致错误。

js
const panel = document.querySelector('.panel');

if (panel) {
  panel.textContent = '已加载';
}

预期结果

text
存在 panel 元素时更新内容,不存在时不会执行操作。

另外,脚本执行时间也会影响查询结果。如果 JavaScript 在 HTML 元素加载之前运行,可能无法找到目标节点。常见解决方式包括把脚本放在页面底部,或等待 DOM 加载完成后再查询。

理解选择器和查询 API 的关系后,DOM 操作就从“猜元素在哪里”变成了根据页面结构精准定位元素。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

查询页面元素

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

登录哪都通