JavaScript / TypeScript / 系统课时
查询页面元素
查询页面元素
当页面需要根据用户操作、数据变化动态更新内容时,第一步是准确找到目标元素。本篇将学习 JavaScript 中常用的元素查询方法,理解不同选择器的匹配规则,并能够在实际页面脚本中定位需要操作的节点。
学习目标
- 掌握
querySelector和querySelectorAll的基本用法。 - 理解 CSS 选择器在 DOM 查询中的作用。
- 能根据页面结构选择合适的元素查询方式。
使用 querySelector 查询单个元素
querySelector 会接收一个 CSS 选择器字符串,并返回匹配到的第一个元素。如果页面中存在多个符合条件的节点,它只返回第一个结果。
例如,一个页面中有多个按钮,但只需要操作第一个主要按钮时,可以使用这种方式:
<button class="action">保存</button>
<button class="action">取消</button>const button = document.querySelector('.action');
button.textContent = '提交';预期结果
页面中第一个 class 为 action 的按钮文字变为“提交”。querySelector 支持常见 CSS 选择器,包括标签选择器、类选择器、ID 选择器和属性选择器。
常见写法如下:
| 选择器 | 示例 | 匹配内容 |
|---|---|---|
| 标签 | div |
所有 div 元素中的第一个 |
| 类名 | .item |
class 包含 item 的元素 |
| ID | #header |
id 为 header 的元素 |
| 属性 | [data-id] |
存在指定属性的元素 |
使用 querySelectorAll 查询多个元素
当页面需要批量处理多个元素时,应使用 querySelectorAll。它会返回所有匹配元素组成的 NodeList。
例如,为列表中的所有按钮添加点击事件:
const buttons = document.querySelectorAll('.action');
buttons.forEach((button) => {
button.addEventListener('click', () => {
console.log(button.textContent);
});
});预期输出
点击任意 action 按钮后,控制台输出对应按钮文字。与数组类似,NodeList 支持 forEach 遍历,但它并不是普通数组。如果需要使用数组方法,可以转换:
const elements = Array.from(document.querySelectorAll('.action'));根据页面结构选择查询方式
实际开发中,选择查询方式的关键不是记住 API,而是根据操作目标判断范围。
如果目标唯一,例如页面标题、登录区域,可以优先使用 ID 或精确选择器:
const title = document.querySelector('#page-title');如果需要处理一组相同组件,例如商品卡片、菜单项,则使用 querySelectorAll:
const cards = document.querySelectorAll('.product-card');选择器越精确,代码越不容易因为页面结构变化而误操作。
查询元素时的常见问题
如果选择器没有匹配任何元素,querySelector 会返回 null,继续访问属性会导致错误。
const panel = document.querySelector('.panel');
if (panel) {
panel.textContent = '已加载';
}预期结果
存在 panel 元素时更新内容,不存在时不会执行操作。另外,脚本执行时间也会影响查询结果。如果 JavaScript 在 HTML 元素加载之前运行,可能无法找到目标节点。常见解决方式包括把脚本放在页面底部,或等待 DOM 加载完成后再查询。
理解选择器和查询 API 的关系后,DOM 操作就从“猜元素在哪里”变成了根据页面结构精准定位元素。