讲师中心 微信公众号
AI工具推荐 视频效率加速

怎么用JavaScript精准监听动态引入CSS的完成状态?

酷雪大大_2403

酷雪大大_2403

发布时间:2026-11-08 11:05:27

|

258人浏览过

|

来源于php中文网

原创

link.onload不可靠,应组合onload、onerror、document.styleSheets轮询及超时兜底;因缓存、跨域、浏览器兼容性导致事件不触发,需try/catch访问cssRules并设50ms轮询与10秒超时。

怎么用javascript精准监听动态引入css的完成状态?

link.onload 不可靠,尤其在缓存命中或跨域时可能根本不触发。真正能落地的方案是组合使用 onload、onerror 和 document.styleSheets 检查,再加一层超时兜底。

为什么 link.onload 会失效

Chrome/Firefox 对本地缓存的 CSS 文件常跳过 load 事件;Safari 在某些版本中对 rel="stylesheet" 的 link 元素不触发 onload;跨域 CSS 因 CORS 限制,即使加载成功也无法读取规则,但事件也不一定触发。
常见错误现象:console.log('loaded') 从不执行,但样式确实生效了。

用 document.styleSheets 主动轮询是否加载完成

核心逻辑是:拿到刚插入的 link 元素后,遍历 document.styleSheets 找到匹配 href 的项,再尝试读取其 cssRules(注意不是 rules,IE 已淘汰)——只要能读到规则数 ≥ 0,就说明已解析完毕。

要点:

  • 必须用 try/catch 包裹 sheet.cssRules 访问,跨域 CSS 会抛 SecurityError
  • 轮询间隔建议设为 50ms,太短浪费 CPU,太长响应滞后
  • 检查前先确认 sheet.href === link.href,避免误判内联 <style></style> 或其他外部表
  • 若 sheet.disabled === true,跳过该表(比如媒体查询不匹配时)
const link = document.createElement('link');
link.rel = 'stylesheet';
link.href = '/theme/dark.css';
document.head.appendChild(link);

function waitForCSS() {
  for (let i = 0; i < document.styleSheets.length; i++) {
    const sheet = document.styleSheets[i];
    if (sheet.href === link.href && !sheet.disabled) {
      try {
        if (sheet.cssRules && sheet.cssRules.length >= 0) {
          console.log('CSS loaded and parsed');
          return;
        }
      } catch (e) {
        // 跨域,但至少说明 link 已插入并开始加载
        console.warn('Cross-origin CSS loaded, rules inaccessible');
        return;
      }
    }
  }
  setTimeout(waitForCSS, 50);
}
waitForCSS();

必须加超时兜底,否则可能无限等待

网络中断、404、服务端返回空 CSS 等情况会导致轮询永远等不到 cssRules。实际项目里,10 秒是合理上限。

CSS工具箱(专业版)
CSS工具箱(专业版)

全功能 CSS 工程手册,覆盖性能优化、无障碍、设计系统与跨浏览器兼容。

下载

立即学习“Java免费学习笔记(深入)”;

操作建议:

  • 启动轮询时同时启动 setTimeout,超时后清除轮询并触发失败回调
  • 把 link.onerror 和超时逻辑合并处理,统一标记为“加载失败”
  • 失败后可 fallback 到备用样式 URL,或降级为内联基础样式
  • 不要依赖 link.sheet 属性 —— 它在部分浏览器中异步赋值,且 Safari 有时为 null

现代替代方案:用 PerformanceObserver 补充验证

PerformanceObserver 能捕获资源加载完成事件,比轮询更轻量,但不能区分“加载完成”和“解析完成”。它适合做辅助确认,而非唯一依据。

用法要点:

  • 监听 entryTypes: ['resource'],过滤 entry.initiatorType === 'link' 且 entry.name 以 .css 结尾
  • 仅当 entry.duration > 0 且未被 onerror 或超时拦截时,才认为“网络层加载成功”
  • 仍需配合 document.styleSheets 检查,因为资源加载完 ≠ 样式已注入 DOM 渲染树
真正难的不是监听,而是判断“完成”的定义:你是要等网络请求结束?等样式表解析完成?还是等浏览器应用样式并触发重排?多数业务场景下,只有等到 cssRules 可读,才能安全地调用 getComputedStyle 或基于该 CSS 的 JS 逻辑 —— 这一点很容易被忽略。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

5686

2023.06.20

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

1369

2023.07.04

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

5604

2023.07.04

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

1040

2023.09.01

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

1996

2023.09.04

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

3905

2023.09.04

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

5133

2023.09.12

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

3360

2023.09.20

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn