因为document.readystate≠"complete"时隐藏preloader会导致css、图片等资源未加载完而出现闪屏或布局偏移;正确做法是等待字体、首屏图片及关键资源就绪,并设3–5秒超时兜底。

为什么 document.readyState 不等于 "complete" 时就隐藏 preloader 是错的
很多实现直接监听 DOMContentLoaded 或检查 document.readyState === "complete" 后立刻移除 preloader,结果用户看到页面闪一下、文字重排、图片突然下推——因为 CSS 和图片还没加载完。preloader 的目标不是“DOM 就绪”,而是“视觉内容可稳定呈现”。关键判断点得落在资源加载完成之后。
-
DOMContentLoaded触发时,<link rel="stylesheet">可能还在解析中,字体、背景图未生效 -
window.onload确保所有资源(含图片、iframe)加载完毕,但对大图或慢网用户等待过长 - 更优策略:用
document.fonts.load()检查关键字体 + 监听load事件 + 设置超时兜底
用 CSS @font-face + document.fonts.load() 控制字体就绪时机
如果页面用了自定义字体(比如 Inter 或 HarmonyOS Sans),字体未加载完成前浏览器会先用备用字体渲染,等字体到位再重绘,造成 FOIT/FOUT。preloader 必须等关键字体加载成功再结束。
- 确保
@font-face声明中包含font-display: swap(避免阻塞渲染),但 preloader 仍需主动等待 - 调用
document.fonts.load("16px 'Inter'", "a")返回 Promise,第二个参数是测试字符,提高匹配可靠性 - 多个字体要
Promise.all([font1, font2]),别漏掉 icon font(如"1em 'Material Symbols Outlined'")
document.fonts.load("1rem 'Inter'", "A").then(() => {
// 字体就绪,可继续检查其他资源
}).catch(() => {
// 超时或失败,直接进入下一步,避免卡死
});
图片懒加载与 preloader 的冲突怎么破
现代页面普遍用 loading="lazy",但 preloader 存在时,<img> 的懒加载行为可能被中断或延迟触发,导致 preloader 隐藏后大量图片白块闪烁。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- preloader 显示期间,把关键首屏图片的
loading属性临时设为"eager":img.setAttribute("loading", "eager") - 不要等所有
<img>的load事件——有些图片可能 404 或被广告拦截器屏蔽,用IntersectionObserver检测首屏图片是否已渲染(而非仅加载)更可靠 - 对
background-image的 div,需手动读取getComputedStyle(el).backgroundImage并用new Image().src = url预检
超时兜底必须设,且不能只靠 setTimeout
网络异常、CDN 故障、字体服务不可达时,Promise 可能永远不 resolve。没有超时机制的 preloader 会让用户干等甚至以为页面卡死。
- 所有资源等待逻辑都应包装进
Promises.race([resourceLoad, timeoutPromise]) - 超时时间建议 3–5 秒:短于用户耐心阈值,又留出正常加载余量;移动端可略放宽至 6 秒
- 超时后不粗暴移除 preloader,而是加个淡出过渡:
preloader.style.opacity = "0"; setTimeout(() => preloader.remove(), 300),避免突兀消失
最常被忽略的是第三方资源——比如埋点 SDK、评论组件、字体 CDN。它们不参与主流程,但加载失败会影响布局稳定性。真正可靠的 preloader,得把它们也纳入等待清单,或明确标记为“非关键”并隔离加载。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










