1 / 4概念
DOM and Events
DOM 是文档的编程接口,事件是浏览器分发的通知。判断标准不是会不会 querySelector,而是能否说清一次点击经过哪些节点、监听器在哪个阶段执行、改完 DOM 之后浏览器什么时候重排。
1 概念
1.1 一句话定义
DOM 把文档表示成节点树,脚本通过它与页面交互;事件沿树传播,先捕获到目标,再冒泡回根。两者共同构成页面唯一的可变状态。
1.2 它解决什么问题
- 程序化页面:读取与修改结构、属性、样式。
- 交互响应:把用户操作变成通知。
- 批量与委托:一个监听器处理大量子元素。
- 观察变化:尺寸、可见性、结构变化可被监听。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 样式计算与绘制 | Rendering Pipeline |
| Cookie、本地存储、缓存 | Storage |
| 导航、同源策略、Fetch | Navigation and Network |
| 元素的语义与可访问性 | Document Structure and Semantics |
| 框架的声明式更新 | React、Vue、Svelte |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 节点 | 树上的任一位置 | 元素只是节点的一种 |
| 元素 | 节点的一种,对应标签 | 文本、注释也是节点 |
| 文档片段 | 轻量容器,可批量插入 | 插入后自身清空 |
| 事件流 | 捕获、目标、冒泡 | 不是所有事件都冒泡 |
| 委托 | 在祖先上监听 | 依赖冒泡 |
target | 事件最初的目标 | 与 currentTarget 不同 |
| 被动监听 | 承诺不阻止默认行为 | 滚动性能关键 |
| 观察者 | 异步通知变化 | 回调在微任务或渲染后 |
| 影子根 | 隔离的子树 | 样式与选择器隔离 |
2 机制
2.1 心智模型
把页面想成一棵可变树。脚本在树上查、改、插、删;浏览器在树变化后标记脏区,等当前任务结束再统一计算样式与布局。事件则从根向目标再返回,任一节点都能拦。
2.2 机制拆解
- 节点类型:元素、文本、注释、文档、文档片段、文档类型是常用类型,其余类型基本不直接操作。
- 查询:
querySelector用 CSS 选择器,getElementById最快,closest向上找,matches判断匹配。 - 修改:
createElement加append精确控制;innerHTML会重新解析,带来注入风险;textContent只处理文本。 - 批量插入:先用
DocumentFragment组装再一次性插入,只触发一次结构变化。 - 事件流:从根捕获到目标,再冒泡回根;
addEventListener的capture决定阶段。 - 阻止行为:
preventDefault取消默认动作,stopPropagation阻止后续节点收到事件。 - 委托:在祖先监听,用
target.closest找到真实目标,适合列表与动态内容。 - 观察者:
MutationObserver监听结构,ResizeObserver监听尺寸,IntersectionObserver监听可见性。 - 影子 DOM:
attachShadow创建隔离子树,样式与选择器不穿透。
2.3 完整枚举
常用的节点类型:
| 类型 | 常量 | 用途 |
|---|---|---|
| 元素 | Node.ELEMENT_NODE | 标签 |
| 文本 | Node.TEXT_NODE | 文字内容 |
| 注释 | Node.COMMENT_NODE | 注释 |
| 文档 | Node.DOCUMENT_NODE | 整个文档 |
| 文档片段 | Node.DOCUMENT_FRAGMENT_NODE | 批量插入 |
| 文档类型 | Node.DOCUMENT_TYPE_NODE | 文档声明 |
监听器的选项:
| 选项 | 作用 |
|---|---|
capture | 在捕获阶段触发 |
once | 触发一次后自动移除 |
passive | 承诺不调用 preventDefault |
signal | 用信号统一移除 |
四种观察者:
| 观察者 | 监听对象 | 典型用途 |
|---|---|---|
MutationObserver | 结构、属性、文本变化 | 第三方脚本注入监测 |
ResizeObserver | 元素尺寸 | 容器查询的脚本替代 |
IntersectionObserver | 与视口的交叉 | 懒加载、曝光统计 |
PerformanceObserver | 性能条目 | 指标上报 |
插入与删除的 API:
| 操作 | 写法 |
|---|---|
| 创建 | document.createElement('div') |
| 追加 | parent.append(node) |
| 前置 | parent.prepend(node) |
| 相对插入 | node.before(other)、node.after(other) |
| 替换 | node.replaceWith(other) |
| 删除 | node.remove() |
| 批量 | fragment.append(...nodes) |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| DOM 节点数 | 数千以内较好 | 影响解析与布局 |
| 监听器数量 | 与交互点成正比 | 委托可大幅减少 |
| 布局抖动 | 每次强制同步一次 | 读后写再读最贵 |
| 观察者回调 | 渲染后批量 | 不要在里面改布局 |
3 实践
3.1 最小示例
一个列表用事件委托处理点击,用 CustomEvent 向外通报,用片段批量插入。
const list = document.querySelector('#list');
list.addEventListener('click', (event) => {
const row = event.target.closest('[data-id]');
if (!row) return;
list.dispatchEvent(
new CustomEvent('row:select', {
bubbles: true,
detail: {id: row.dataset.id},
}),
);
});
const fragment = document.createDocumentFragment();
for (const item of items) {
const li = document.createElement('li');
li.dataset.id = item.id;
li.textContent = item.name;
fragment.append(li);
}
list.append(fragment);
追踪:点击落在子元素上,事件冒泡到 #list,closest 向上找到带 data-id 的行;派发自定义事件时 bubbles 让外层也能收到。批量插入用片段,浏览器只做一次结构变更,而不是每次 append 都触发一次布局。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 查单个 | querySelector('.card') | 返回第一个 |
| 查多个 | querySelectorAll('.card') | 静态列表 |
| 向上查 | target.closest('.card') | 委托常用 |
| 判断匹配 | element.matches('.active') | 布尔结果 |
| 改文本 | element.textContent = text | 自动转义 |
| 改结构 | element.replaceChildren(...nodes) | 一次替换 |
| 加类 | element.classList.toggle('open') | 不拼接字符串 |
| 读数据 | element.dataset.id | 对应 data-id |
| 移除监听 | AbortController 加 signal | 成组清理 |
3.3 标准流程
- 先确认这件事能不能用语义元素与 CSS 完成。
- 需要脚本时,先选查询范围,再选修改方式。
- 事件优先用委托,避免为每个子元素绑定。
- 批量修改先组装片段,再一次性插入。
- 读布局与写布局分开,避免强制同步。
- 组件卸载时统一移除监听与观察者。
3.4 与相邻技术的组合
- HTML:结构决定选择器与委托层级。
- CSS:改类切换样式比改内联样式更容易维护。
- 渲染:DOM 修改会标脏,浏览器在下一帧统一处理。
- 存储与网络:交互常触发请求与持久化,注意异步竞态。
- 框架:框架管理 DOM 时,直接操作同一节点会冲突。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 修改方式 | textContent / innerHTML / 节点 API | 安全与性能 |
| 监听方式 | 直接绑定 / 委托 | 数量与动态内容 |
| 时机 | 同步 / 微任务 / 帧回调 | 布局次数 |
| 隔离 | 普通树 / 影子树 | 样式与选择器范围 |
3.6 决策规则
- 插入用户内容只用
textContent或净化后的innerHTML。 - 列表与动态内容用委托,不为每项绑定。
- 滚动与触摸监听加
passive: true。 - 批量结构变更用片段或
replaceChildren。 - 读
offsetWidth这类属性会强制布局,集中读再集中写。 - 监听器与观察者都要有明确的移除路径。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 节点 API | 精确、安全 | 代码略长 | 复杂结构 |
textContent | 自动转义 | 只处理文本 | 纯文本更新 |
innerHTML | 写得快 | 注入风险、重解析 | 可信静态片段 |
| 事件委托 | 监听器少 | 依赖冒泡 | 列表 |
| 观察者 | 异步、省轮询 | 回调时机难测 | 尺寸与可见性 |
3.8 何时不该用
- 不要用
innerHTML拼接用户输入。 - 不要为每个列表项绑定监听器,用委托。
- 不要在循环里读布局属性,会触发多次重排。
- 不要在框架管理的节点上直接改结构。
- 不要用轮询代替观察者。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 出现脚本注入 | innerHTML 拼接输入 | textContent 或净化 |
| 页面越用越卡 | 监听器未移除 | 统一清理 |
| 滚动卡顿 | 监听器未标被动 | passive: true |
| 修改后立刻读尺寸不准 | 强制同步布局 | 先写后读 |
| 委托在深层组件失效 | 事件被 stopPropagation | 去掉阻止冒泡 |
| 影子树外拿不到节点 | 选择器不穿透 | 用 shadowRoot |
| 观察者回调死循环 | 回调里改了被观察的属性 | 拆分或加条件 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 字符串拼 HTML | XSS 与重解析 | 节点 API |
| 监听器绑定到每个元素 | 内存与性能 | 委托 |
| 轮询尺寸 | 掉帧 | ResizeObserver |
用 document.write | 破坏文档 | 节点 API |
| 全局变量存节点 | 泄漏 | 局部引用 |
4.3 可观测信号
监听器与观察者数量、每次交互的布局次数、长任务时长、DOM 节点数增长、滚动的帧率、错误栈中的 DOM 异常。
4.4 安全 / 性能 / 一致性边界
- 注入边界:任何把字符串当 HTML 解析的入口都是 XSS 面,包括
insertAdjacentHTML。 - 性能边界:DOM 修改的代价在样式与布局计算,不在赋值本身。
- 一致边界:影子树内的样式与选择器不穿透,跨树通信要走属性与事件。
- 生命周期边界:节点被移除后监听器仍可能持有引用,泄漏由此产生。