DOM加载完成事件监听方法
2026-05-20 21:09:34
0浏览
收藏
本文深入解析了网页开发中至关重要的 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学习网公众号了解相关技术文章。
好分数app如何扫描试卷录入?
- 上一篇
- 好分数app如何扫描试卷录入?
- 下一篇
- 中国邮政物流查询官网入口
查看更多
最新文章
-
- 文章 · 前端 | 3天前 | 前端 · javascript · 滚动容器 · 用户体验 · 浏览器 API · JavaScript scrollIntoView container: nearest 嵌套滚动容器 前端滚动
- scrollIntoView 的 container 怎么选:嵌套滚动容器避免页面被带走
- 447浏览 收藏
-
- 文章 · 前端 | 3天前 | spa · Web API · 前端教程 · 浏览器路由 · 前端路由 SPA路由 Navigation API History API navigate事件
- Navigation API 如何统一拦截 SPA 路由:从 History API 迁移的最小方案
- 183浏览 收藏
-
- 文章 · 前端 | 3天前 | 性能优化 · 编译器 · typescript · CI · TypeScript 7 checkers builders CI并行编译
- TypeScript 7 并行编译怎么调:checkers、builders 与 CI 资源预算
- 386浏览 收藏
-
- 文章 · 前端 | 3天前 | 布局 · 前端 · css · anchor-name CSS anchor positioning position-try
- CSS Anchor Positioning 做悬浮提示:锚点边界与回退写法
- 389浏览 收藏
-
- 文章 · 前端 | 4天前 | 浏览器 · javascript · 前端性能 · Web API · 响应式设计 · JavaScript 响应式布局 ResizeObserver contentRect disconnect
- JavaScript ResizeObserver 如何避免响应式死循环:contentRect、阈值与 disconnect 边界
- 257浏览 收藏
-
- 文章 · 前端 | 4天前 |
- JavaScript View Transitions 如何避免并发导航动画冲突:skipTransition、finished 与回滚状态
- 327浏览 收藏
-
- 文章 · 前端 | 4天前 |
- CSS container-type 实战:让卡片组件按自身宽度切换布局
- 266浏览 收藏
-
- 文章 · 前端 | 4天前 |
- HTML dialog closedby 如何区分 Esc、点击外部与强制关闭:关闭原因和兼容降级
- 479浏览 收藏
查看更多
课程推荐
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
查看更多
AI推荐
-
- SuperCLUE
- SuperCLUE是权威的中文大语言模型综合评测基准,涵盖语言理解、知识应用、AI Agent智能体及安全性等12项核心能力。通过多轮对话与客观测试,定期发布榜单与技术报告,为模型研发、优化及行业选型提供科学依据。
- 123次使用
-
- C-Eval
- 深入了解C-Eval中文评估套件,涵盖52个学科与4级难度。本文详解其功能特点、Zero-shot/Few-shot使用方法及代码示例,助您全面评测LLM中文理解与泛化能力。
- 42次使用
-
- Google AI提示词库
- 探索Google Cloud官方生成式AI提示词库,提供免费、无需登录的中英双语Prompt模板。涵盖内容创作、代码优化、数据分析等场景,助您快速提升AI交互效率与质量。
- 19次使用
-
- Gradio
- Gradio是一个用于构建机器学习和数据科学Web应用的开源Python库。支持快速创建交互界面,获Google、Meta等大厂青睐,适合模型演示、部署反馈及调试。
- 125次使用
-
- AgentGPT
- 深入了解AgentGPT:一款基于浏览器的自主人工智能代理工具。本文解析其核心功能、技术栈、应用场景,并提供详细的在线使用及本地部署教程,助您高效利用AI自动化完成任务。
- 18次使用
查看更多
相关文章
-
- JavaScript函数定义及示例详解
- 2025-05-11 502浏览
-
- 智能体安全引领产业升级——国内AI安全产品市场深度分析
- 2026-08-21 501浏览
-
- CSS变量简化按钮悬停效果技巧
- 2026-05-31 501浏览
-
- JavaScript符号类型详解与应用
- 2026-05-31 501浏览
-
- HTML剪贴板复制粘贴怎么用
- 2026-05-26 501浏览

