FontFaceSet

Baseline 广泛可用 *

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

* 此特性的某些部分可能存在不同级别的支持。

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

FontFaceSet 接口是 CSS 字体加载 API 的一部分,用于管理字体的加载以及查询它们的下载状态。

FontFaceSet 实例是一个 类似 Set 的对象,可以包含一个有序的 FontFace 对象集合。

此属性可以通过 Document.fonts 访问,或者在 Web Workers 中通过 self.fonts 访问。

EventTarget FontFaceSet

实例属性

FontFaceSet.status 只读

指示字体的加载状态。它将是 'loading''loaded' 之一。

FontFaceSet.ready 只读

一个 Promise,当字体加载和布局操作完成后,它将解析。

FontFaceSet.size 只读

返回 FontFaceSet 中值的数量。

事件

loading

当字体集开始加载时触发。

loadingdone

当字体集加载完成时触发。

loadingerror

当加载字体集时发生错误时触发。

实例方法

FontFaceSet.add()

将一个字体添加到字体集中。

FontFaceSet.check()

一个布尔值,指示字体是否已加载,但当字体未加载时不会启动加载。

FontFaceSet.clear()

从字体集中移除所有手动添加的字体。CSS 连接的字体不受影响。

FontFaceSet.delete()

从字体集中移除手动添加的字体。CSS 连接的字体不受影响。

FontFaceSet.entries()

返回一个新迭代器,其中包含 FontFaceSet 中每个元素的值,按插入顺序排列。

FontFaceSet.forEach()

FontFaceSet 对象中的每个值执行提供的函数。

FontFaceSet.has()

返回一个 Boolean 值,指示是否存在具有给定值的元素。

FontFaceSet.keys()

FontFaceSet.values() 的别名。

FontFaceSet.load()

返回一个 Promise,该 Promise 解析为一个请求的字体的字体列表。

FontFaceSet.values()

返回一个新的迭代器对象,该对象按插入顺序产生 FontFaceSet 对象中每个元素的值。

规范

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

浏览器兼容性