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 未知 未知 未知 未知 未知 未知 未知