DOM加载完成事件监听方法
时间:2026-05-20 21:09:34 180浏览 收藏
本文深入解析了网页开发中至关重要的 DOM 加载时机问题,明确指出 `document.addEventListener('DOMContentLoaded', ...)` 是监听 DOM 就绪最可靠、高效且语义正确的方案——它在 HTML 解析完成、DOM 树构建完毕后立即触发,无需等待图片、CSS 等外部资源,避免了 `onload` 的严重延迟和适用范围局限;同时澄清了常见误区,如误用 `onload` 属性于非法标签、依赖脚本位置“碰运气”、混淆 DOMContentLoaded 与 window.onload 的本质差异(核心在于“是否等待资源加载”),并揭示了 CSS 阻塞对布局计算的真实影响,帮助开发者写出更健壮、可维护的初始化逻辑。

用 document.addEventListener('DOMContentLoaded', ...),不是 onload,也不是把脚本塞在 底部碰运气。
为什么不能用 onload 属性写在任意标签上
比如 这种写法浏览器直接忽略——onload 不是 的合法属性。HTML 规范只允许它出现在 、、、 等少数元素上。强行加只会让代码看起来像在运行,实际什么也没触发。
常见错误现象:
- 控制台没报错,但函数完全不执行
- 页面刷新后偶尔生效、偶尔失效(其实是 DOM 尚未就绪时脚本已执行)
DOMContentLoaded 和 window.onload 到底差在哪
关键区别不在“谁先谁后”,而在“等不等资源”:
DOMContentLoaded:HTML 解析完、DOM 树建好就触发,不管 CSS、图片、字体有没有加载完window.onload:所有资源(含图片、样式表、子 iframe)全部下载并解析完成才触发,通常晚几百毫秒甚至几秒
所以:
- 要绑定按钮点击、读取
document.body、初始化菜单——用DOMContentLoaded - 要获取图片真实尺寸、依赖 CSSOM 计算布局(比如
getBoundingClientRect())——得等window.onload或手动监听document.fonts.load等 - 如果用了
link[rel=stylesheet]且没加media="print"等惰性加载策略,DOMContentLoaded触发时 CSSOM 可能还没就绪,getComputedStyle()返回空值或默认值
监听 DOMContentLoaded 的正确写法和坑点
最稳妥的写法就是直接监听 document:
document.addEventListener('DOMContentLoaded', function() {
console.log('DOM 已就绪');
const el = document.getElementById('main');
if (el) el.classList.add('loaded');
});
注意事项:
- 这段代码可以放在
里,也可以放在任何位置,浏览器会缓存事件并等 DOM 就绪后派发 - 不要用
document.onreadystatechange+readyState === 'interactive'来模拟,行为不一致且 IE 兼容性差 - 别在回调里反复调用
document.getElementById却不判空——元素可能真不存在,得自己加if - 事件只触发一次,不需要手动
removeEventListener,除非你主动注册了多次且想中途取消
脚本位置和执行时机的真实关系
很多人以为把 放在 前面就“一定安全”,其实有例外:
- 如果前面有同步加载的外部脚本(比如没加
async或defer的),而它内部又执行了耗时操作(如大循环、同步 XHR),那后面的内联脚本仍可能在 DOM 就绪前执行 DOMContentLoaded是浏览器级信号,比“脚本位置”更可靠;它确保 HTML 解析器已完成工作,无论脚本怎么放- 现代项目中,如果用了模块化打包(如 Vite、Webpack),入口脚本默认就是等 DOM 就绪后才执行,本质仍是封装了
DOMContentLoaded逻辑
真正容易被忽略的是 CSS 阻塞:哪怕 DOM 已就绪,只要关键样式表还没解析完,offsetHeight、clientWidth 这类布局 API 就可能返回 0 或过时值——这不是事件监听的问题,而是渲染流水线本身的依赖关系。
文中关于的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《DOM加载完成事件监听方法》文章吧,也可关注golang学习网公众号了解相关技术文章。
相关阅读
更多>
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
最新阅读
更多>
-
499 收藏
-
157 收藏
-
383 收藏
-
482 收藏
-
382 收藏
-
150 收藏
-
310 收藏
-
314 收藏
-
359 收藏
-
421 收藏
-
141 收藏
-
311 收藏
课程推荐
更多>
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习