FontFace - 代表一个可用的字体
这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。
FontFace
接口代表一个可用的字体。它允许控制字体的源,作为外部资源的 URL 或缓冲;它还允许控制何时加载字体及其当前状态。
构造函数
FontFace()
构造并返回一个新的 FontFace
对象,该对象是由 URL 描述的外部资源或 ArrayBuffer
构建的。
属性
该接口不继承任何属性。
FontFace.display
一个 CSSOMString
,它根据是否以及何时下载并准备使用来确定字体的显示方式。
FontFace.family
一个 CSSOMString
,它表示字体的 family。它等同于 font-family
描述符。
FontFace.style
一个 CSSOMString
,它表示字体的样式。它等同于 font-style
描述符。
FontFace.weight
一个 CSSOMString
,它表示字体的宽度。它等同于 font-weight
描述符。
FontFace.stretch
一个 CSSOMString
,它表示字体的拉伸方式。它等同于 font-stretch
描述符。
FontFace.unicodeRange
一个 CSSOMString
,表示字体的代码范围。它等同于 unicode-range
描述符。
FontFace.variant
一个 CSSOMString
,表示字体的 variant。它等同于 font-variant
描述符。
FontFace.featureSettings
一个 CSSOMString
,表示字体的 features,它等同于 font-feature-settings
描述符。
FontFace.status
只读
返回一个枚举值,指示字体的状态。它可以是以下之一: "unloaded"
,"loading"
,"loaded"
或 "error"
。
FontFace.loaded
只读
返回一个 Promise
,字体完全加载完时解析为 FontFace
对象,发生错误则调用 reject
方法。
方法
该接口不继承任何方法。
FontFace.load()
加载字体,返回一个 Promise
,字体完全加载完时解析为 FontFace
对象,发生错误则调用 reject
方法。
规范
规范 | 状态 | 备注 |
---|---|---|
CSS Font Loading Module Level 3 FontFaceSet 的定义 |
工作草案 | 初始定义 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 35 | 未知 | 41 | 未知 | 未知 | 未知 |
FontFace() constructor |
35 | 未知 | 41 | 未知 | 未知 | 未知 |
display |
60 | 未知 | 不支持 | 未知 | 47 | 不支持 |
family |
支持 | 未知 | 未知 | 未知 | 支持 | 未知 |
style |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
weight |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
stretch |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
unicodeRange |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
variant |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
featureSettings |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
status |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
loaded |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
load |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 35 | 35 | 未知 | 41 | 未知 | 未知 | 未知 |
FontFace() constructor |
35 | 35 | 未知 | 41 | 未知 | 未知 | 未知 |
display |
60 | 60 | 未知 | 不支持 | 未知 | 47 | 不支持 |
family |
支持 | 支持 | 未知 | 未知 | 未知 | 支持 | 未知 |
style |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
weight |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
stretch |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
unicodeRange |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
variant |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
featureSettings |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
status |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
loaded |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |
load |
未知 | 未知 | 未知 | 未知 | 未知 | 未知 | 未知 |