FontFaceSet: load() 方法

FontFaceSetload() 方法强制加载参数中给定的所有字体。

语法

js
load(font)
load(font, text)

参数

font

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

text

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

返回值

一个 Promise,其结果为已加载的 FontFace 对象的 Array。当所有字体都加载完成后,该 Promise 将被 fulfilled;如果其中一个字体加载失败,则该 Promise 将被 rejected。

示例

以下示例返回一个 Promise,根据加载“MyFont”的成功与否,该 Promise 将被 fulfilled 或 rejected。then() 中的代码可以假设该字体可用。

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

规范

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

浏览器兼容性

BCD 表格仅在浏览器中加载