FontFaceSet
FontFaceSet
接口是 CSS 字体加载 API 的一部分,用于管理字体面加载和查询它们的下载状态。
FontFaceSet
实例是一个 Set
类对象,可以保存一组有序的 FontFace
对象。
此属性可用作 Document.fonts
,或在 Web 工作线程 中作为 self.fonts
。
实例属性
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
,解析为所请求字体的字体面列表。 FontFaceSet.values()
-
返回一个新的迭代器对象,按插入顺序生成
FontFaceSet
对象中每个元素的值。
规范
规范 |
---|
CSS 字体加载模块第 3 级 # FontFaceSet 接口 |
浏览器兼容性
BCD 表格仅在浏览器中加载