文档:fonts 属性

fonts 属性是 Document 接口的一个属性,它返回文档的 FontFaceSet 接口。

此功能是 CSS 字体加载 API 的一部分。

返回的值是文档的 FontFaceSet 接口。FontFaceSet 接口可用于加载新字体、检查以前加载的字体的状态等。

示例

字体加载完成后执行操作

js
document.fonts.ready.then((fontFaceSet) => {
  // Any operation that needs to be done only after all used fonts
  // have finished loading can go here.
  const fontFaces = [...fontFaceSet];
  console.log(fontFaces);
  // some fonts may still be unloaded if they aren't used on the site
  console.log(fontFaces.map((f) => f.status));
});

当所有使用的字体的加载和布局操作完成时,Promise 将被兑现。使用的字体集可能与声明的字体集不同,例如,如果可选字体(即通过 font-display: optional 声明的字体)无法及时加载。

规范

规范
CSS 字体加载模块级别 3
# FontFaceSet 接口

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅