首页 > web前端 > js教程 > 正文

JS怎样检测字体加载完成 4个回调函数确保字体加载后渲染

穿越時空
发布: 2025-06-25 14:23:01
原创
793人浏览过

处理字体加载失败的方法包括:1. 设置超时时间,通过 fontfaceobserver 的超时参数确保长时间未加载时触发失败回调;2. 使用 css 设置备用字体以保证内容可读性;3. 在失败回调中加入重试机制,并限制最大重试次数防止无限循环;4. 提示用户刷新页面或检查网络连接。此外,优化字体加载性能可通过使用 woff2 格式、字体子集化、cdn 托管、预加载字体文件以及合理设置 font-display 属性避免 foit 和 fout 问题。浏览器对 fontface api 支持良好,现代浏览器均可使用,而老浏览器需降级处理。综合运用 fontfaceobserver 及相关策略可有效提升字体加载的稳定性和用户体验。

JS怎样检测字体加载完成 4个回调函数确保字体加载后渲染

JS检测字体加载完成,核心在于利用浏览器的字体加载API,并结合回调函数,确保在字体可用后才进行渲染,避免出现“闪烁”或排版错乱。关键点在于FontFaceObserver或类似库的使用,以及对不同浏览器兼容性的处理。

JS怎样检测字体加载完成 4个回调函数确保字体加载后渲染
// 假设你已经引入了 FontFaceObserver 库

function detectFontLoad(fontFamily, successCallback, loadingCallback, activeCallback, inactiveCallback) {
  const font = new FontFaceObserver(fontFamily);

  font.load().then(function () {
    console.log(fontFamily + ' 加载成功');
    if (successCallback) successCallback();
    if (activeCallback) activeCallback(); // 触发 active 回调,表示字体已成功加载并激活
  }, function () {
    console.log(fontFamily + ' 加载失败');
    if (inactiveCallback) inactiveCallback(); // 触发 inactive 回调,表示字体加载失败
  });

  if (loadingCallback) loadingCallback(); // 立即触发 loading 回调,表示字体开始加载
}

// 使用示例
detectFontLoad('MyCustomFont',
  function() {
    // 字体加载成功后的处理
    document.body.classList.add('fonts-loaded'); // 添加一个 class,通过 CSS 控制渲染
  },
  function() {
    // 字体开始加载
    console.log('字体开始加载...');
  },
  function() {
    // 字体已激活(成功加载并应用)
    console.log('字体已激活!');
  },
  function() {
    // 字体加载失败
    console.error('字体加载失败!');
  }
);

// CSS 示例 (配合 JS)
/*
body {
  font-family: sans-serif; // 默认字体
}

body.fonts-loaded {
  font-family: 'MyCustomFont', sans-serif; // 替换为自定义字体
}
*/
登录后复制

如何处理字体加载失败的情况?

字体加载失败是真实存在的,网络不稳定、字体文件损坏都可能导致失败。不能仅仅依赖于成功加载的回调。

JS怎样检测字体加载完成 4个回调函数确保字体加载后渲染
  1. 设置超时: FontFaceObserver 允许设置超时时间。超过这个时间,即使字体没有加载完成,也会触发失败回调。
  2. 回退字体: 在 CSS 中,始终设置一个备用字体。如果自定义字体加载失败,浏览器会自动使用备用字体,保证内容的可读性。
  3. 重试机制: 可以尝试在失败回调中重新加载字体。但要注意避免无限循环,可以设置最大重试次数。
  4. 用户提示: 如果字体加载持续失败,可以向用户显示一个提示信息,告知他们可能需要刷新页面或检查网络连接。
// 改进后的 detectFontLoad 函数,增加超时和重试机制
function detectFontLoadWithRetry(fontFamily, successCallback, loadingCallback, activeCallback, inactiveCallback, maxRetries = 3, retryDelay = 1000) {
  let retries = 0;

  function loadFont() {
    const font = new FontFaceObserver(fontFamily);

    font.load(null, 5000).then(function () { // 设置超时时间为 5 秒
      console.log(fontFamily + ' 加载成功');
      if (successCallback) successCallback();
      if (activeCallback) activeCallback();
    }, function () {
      console.warn(fontFamily + ' 加载失败,重试中... (第 ' + (retries + 1) + ' 次)');
      if (retries < maxRetries) {
        retries++;
        setTimeout(loadFont, retryDelay); // 延迟后重试
      } else {
        console.error(fontFamily + ' 加载失败,已达到最大重试次数');
        if (inactiveCallback) inactiveCallback();
      }
    });

    if (loadingCallback && retries === 0) loadingCallback(); // 只在第一次加载时触发 loading 回调
  }

  loadFont();
}

// 使用示例
detectFontLoadWithRetry('MyCustomFont',
  function() { document.body.classList.add('fonts-loaded'); },
  function() { console.log('字体开始加载...'); },
  function() { console.log('字体已激活!'); },
  function() { console.error('字体加载失败!'); }
);
登录后复制

如何优化字体加载性能?

字体加载对网站性能有显著影响,特别是对于移动设备。

JS怎样检测字体加载完成 4个回调函数确保字体加载后渲染
  1. 使用 Web Font Loader (或类似库): 如 FontFaceObserver,提供更精细的控制和事件监听。
  2. 字体格式优化: 使用 WOFF2 格式,压缩率更高,兼容性更好。
  3. 字体子集化: 只包含页面实际使用的字符,减少字体文件大小。可以使用工具如 fontmin。
  4. CDN 加速: 将字体文件托管在 CDN 上,利用 CDN 的缓存和加速能力。
  5. 预加载 (preload): 使用 标签,提前加载字体文件。
<link rel="preload" href="fonts/MyCustomFont.woff2" as="font" type="font/woff2" crossorigin>
登录后复制
  1. 避免 FOIT 和 FOUT: FOIT (Flash of Invisible Text) 指字体加载完成前显示空白,FOUT (Flash of Unstyled Text) 指字体加载完成后替换默认字体导致闪烁。通过 CSS 和 JS 的配合,可以尽量避免这两种情况。

不同浏览器对字体加载 API 的支持程度如何?

虽然 FontFaceObserver 这样的库已经做了很好的兼容性处理,但了解底层 API 的支持情况仍然很重要。

  1. FontFace API: 现代浏览器都支持 FontFace API,允许通过 JS 加载和控制字体。
  2. font-display: CSS font-display 属性控制字体加载期间的行为。swap 值表示先显示备用字体,字体加载完成后再替换。optional 值表示如果字体加载时间过长,则不使用自定义字体。
  3. 老的浏览器: 对于不支持 FontFace API 的老浏览器,需要使用一些 hack 的方法,或者直接降级到使用系统字体。但这种情况现在已经很少见了。

总的来说,使用 FontFaceObserver 结合 CSS font-display 属性,可以很好地处理字体加载的各种情况,并提供良好的用户体验。不过,始终要记住,字体加载是性能优化的一个重要方面,需要综合考虑各种因素。

以上就是JS怎样检测字体加载完成 4个回调函数确保字体加载后渲染的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习
PHP中文网抖音号
发现有趣的

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号