FontFaceSet: load() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流浏览器均已支持。

注意:此功能在 Web Workers 中可用。

FontFaceSet 接口的 load() 方法强制加载参数中给定的所有字体。

语法

js
load(font)
load(font, text)

参数

font

使用 CSS 值语法指定的字体规范,例如:“italic bold 16px Roboto”

文本

将字体限制为 Unicode 范围包含 text 中至少一个字符的那些字体。这不会检查单个字形覆盖

返回值

一个 Promise,它在加载完成时使用已加载的 FontFace 对象的 Array 进行兑现。当所有字体加载完成时,Promise 将兑现;如果其中一个字体加载失败,它将被拒绝。

示例

以下示例返回一个 Promise,该 Promise 将根据“MyFont”的加载成功与否进行兑现或拒绝。then() 中的代码可以假定该字体可用。

js
document.fonts.load("12px MyFont", "ß").then(/* ... */);

规范

规范
CSS 字体加载模块等级 3
# dom-fontfaceset-load

浏览器兼容性