FontFaceSet - 管理字体加载和查询其下载状态
这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
FontFaceSet
是 CSS 字体加载 API 的接口,用于管理字体加载和查询其下载状态。
属性
FontFaceSet.status
只读
表示 font-face 的加载状态。它将是 'loading'
或 'loaded'
。
事件
FontFaceSet.onloading
一个 EventListener
,每当触发 loading
类型的事件时,都会调用它,表示字体表集已开始加载。
FontFaceSet.onloadingdone
一个 EventListener
,每当触发 loadingdone
类型的事件时调用,表示字体表集已完成加载。
FontFaceSet.onloadingerror
一个 EventListener
,每当触发 loadingerror
类型的事件时调用,表示在加载字体表集时发生错误。
方法
FontFaceSet.add()
向字体集添加字体。
FontFaceSet.check()
返回一个 Boolean
,指示是否加载了字体,但是当它没有加载时不启动加载。
FontFaceSet.clear()
从字体集中删除所有字体。
FontFaceSet.delete()
从字体集中删除一个字体。
FontFaceSet.load()
返回一个 Promise
,它解析为所请求字体的字体列表。
FontFaceSet.ready()
返回 Promise
,一旦字体加载和布局操作完成,它就会解析。
规范
规范 | 状态 | 备注 |
---|---|---|
CSS Font Loading Module Level 3 FontFaceSet 的定义 |
工作草案 | 初始定义 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 35 | 未知 | 41 | 未知 | 未知 | 10 |
status |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
onloading |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
onloadingdone |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
onloadingerror |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
add |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
check |
35 | 未知 | 41 | 未知 | 未知 | 未知 |
clear |
48 | 未知 | 未知 | 未知 | 未知 | 未知 |
delete |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
load |
35 | 未知 | 41 | 未知 | 未知 | 未知 |
ready |
35 | 未知 | 41 | 未知 | 未知 | 未知 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 35 | 35 | 未知 | 41 | 未知 | 未知 | 10 |
status |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
onloading |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
onloadingdone |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
onloadingerror |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
add |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
check |
35 | 35 | 未知 | 41 | 未知 | 未知 | 未知 |
clear |
48 | 48 | 未知 | 未知 | 未知 | 未知 | 未知 |
delete |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
load |
35 | 35 | 未知 | 41 | 未知 | 未知 | 未知 |
ready |
35 | 35 | 未知 | 41 | 未知 | 未知 | 未知 |