CSS如何在Canvas绘图前确保字体样式已引入_利用FontFaceSet API监听加载状态

雨晨君_3948

雨晨君_3948

2026-04-17

345人浏览

原创

不能,fontfaceset.load() 仅触发加载而不保证字体就绪;真正可靠的就绪信号是 document.fonts.ready,它在字体完成加载、解析和注册后才 resolve,需 await 此 promise 再执行 canvas 绘图。

css如何在canvas绘图前确保字体样式已引入_利用fontfaceset api监听加载状态

FontFaceSet.load() 能否阻塞 Canvas 绘图?不能,但可主动等待

直接调用 ctx.font = "24px 'Noto Sans SC'" 后立刻 fillText(),若字体尚未就绪,Canvas 会回退到默认字体(如 sans-serif),且不报错、不重绘——这是最隐蔽的“字体失效”。FontFaceSet.load() 返回 Promise,但它只保证字体资源加载完成,**不保证浏览器已将该字体纳入可用字体集缓存**。必须配合 document.fonts.ready 或显式检查 status。

  • FontFaceSet.load() 是“触发加载”,不是“等待就绪”;它 resolve 时字体可能仍在解析或未注册进渲染管线
  • 真正可靠的就绪信号是 document.fonts.ready Promise,它在所有待加载字体完成加载+解析+注册后才 resolve
  • 若只加载单个字体,也可用 document.fonts.check('24px "Noto Sans SC"') 轮询,但不如 ready 简洁

如何用 document.fonts.ready 安全触发 Canvas 绘图

关键不是“监听”,而是“等待就绪后再执行绘图逻辑”。把 Canvas 渲染封装成函数,等 document.fonts.ready resolve 后再调用:

<pre class="brush:php;toolbar:false;">async function drawWithCustomFont() {
  // 确保字体已声明(CSS 中 @font-face 或 JS 中 new FontFace)
  const font = new FontFace('Noto Sans SC', 'url(/fonts/NotoSansSC-Regular.woff2)');
  document.fonts.add(font);
<p>// 等待字体真正就绪(含加载、解析、注册)
await document.fonts.ready;</p><p>const canvas = document.getElementById('myCanvas');
const ctx = canvas.getContext('2d');
ctx.font = '24px "Noto Sans SC"';
ctx.fillText('你好,Canvas!', 50, 50);
}</p><p>drawWithCustomFont();</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5961" title="Markdown Canvas"><img
														src="https://img.php.cn/upload/skill/000/000/081/179074273835215.jpg" alt="Markdown Canvas" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill5961" title="Markdown Canvas" class="overflowclass">Markdown Canvas</a>
													<p class="overflowclass">将Markdown文件转换为美观的HTML页面,适用于Canvas或浏览器查看。用于用户请求渲染、可视化、显示或分享Markdown文件时。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill5961" title="Markdown Canvas" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>
  • 必须先 document.fonts.add(),否则 document.fonts.ready 不会等待该字体
  • 若字体已在 CSS 中通过 @font-face 声明,可跳过 add(),但需确保 CSS 已加载(如放在 )
  • await document.fonts.ready 是最简方式;不要用 document.fonts.onloadingdone,该事件已被废弃

为什么 ctx.font = '...' 后立即 fillText() 仍可能失败

Canvas 的字体匹配发生在绘制帧提交时刻,而非设置 ctx.font 时。即使字体文件已下载完,浏览器也可能因排版引擎未完成字体元数据解析而临时降级。这种降级不可逆——同一帧内多次 fillText() 都会用降级字体,除非强制触发新帧(如 requestAnimationFrame)。

  • 常见错误:在 DOMContentLoaded 里设置字体 + 绘图,但此时 document.fonts.ready 尚未 resolve
  • 更隐蔽的问题:字体文件返回 200 但内容损坏,document.fonts.load() 仍 resolve,但 document.fonts.ready 会拒绝(reject),需加 catch
  • 移动端 WebKit(iOS Safari)对 document.fonts.ready 支持稳定,但旧 Android WebView 可能无此 API,需降级为定时轮询 check()

兼容性与兜底方案:旧浏览器如何处理

IE 和部分 Android 4.x WebView 不支持 document.fonts。检测后应降级为超时+轮询,避免无限等待:

<pre class="brush:php;toolbar:false;">function waitForFont(fontDesc, timeout = 3000) {
  if ('fonts' in document) {
    return document.fonts.ready;
  }
  return new Promise((resolve) => {
    const start = Date.now();
    const check = () => {
      if (document.fonts.check(fontDesc)) {
        resolve();
      } else if (Date.now() - start > timeout) {
        resolve(); // 超时也继续,避免卡死
      } else {
        setTimeout(check, 100);
      }
    };
    check();
  });
}
<p>// 使用
waitForFont('24px "Noto Sans SC"').then(() => {
ctx.font = '24px "Noto Sans SC"';
ctx.fillText('你好', 50, 50);
});</p>

真正容易被忽略的是:字体加载状态和 Canvas 渲染上下文生命周期无关。如果用户切换标签页再切回,或设备休眠唤醒,字体缓存可能失效,但 Canvas 不会自动重绘——这类场景需要监听 visibilitychange 并重新触发就绪检查。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

css canva

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2949

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2208

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1180

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1118

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1316

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2058

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

3240

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

14495

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

529

3

热门下载

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

精品课程

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

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 5.8万人学习

CSS教程
CSS教程

共754课时 | 96.2万人学习