This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The FontFace
interface represents a single usable font face. It allows control of the source of the font face, being a URL to an external resource, or a buffer; it also allows control of when the font face is loaded and its current status.
Constructor
FontFace()
- Constructs and returns a new
FontFace
object, built from an external resource described by an URL or from anArrayBuffer
.
Properties
This interface doesn't inherit any property.
FontFace.family
- Is a
CSSOMString
that contains the family of the font. It is equivalent to thefont-family
descriptor. FontFace.style
- Is a
CSSOMString
that contains the style of the font. It is equivalent to thefont-style
descriptor. FontFace.weight
- Is a
CSSOMString
that contains the weight of the font. It is equivalent to thefont-weight
descriptor. FontFace.stretch
- Is a
CSSOMString
that contains how the font stretches. It is equivalent to thefont-stretch
descriptor. FontFace.unicodeRange
- Is a
CSSOMString
that contains the range of code encompassed the font. It is equivalent to theunicode-range
descriptor. FontFace.variant
- Is a
CSSOMString
that contains the variant of the font. It is equivalent to thefont-variant
descriptor. FontFace.featureSettings
- Is a
CSSOMString
that contains the features of the font. It is equivalent to thefont-feature-settings
descriptor. FontFace.status
Read only- Returns an enumerated value indicating the status of the font. It can be one of the following:
"unloaded"
,"loading"
,"loaded"
, or"error"
. FontFace.loaded
Read only- Returns a
Promise
to aFontFace
that fulfills when the font is completely loaded and rejects when an error happens.
Methods
This interface doesn't inherit any method.
FontFace.load()
- Loads the font, returning a
Promise
to aFontFace
that fulfills when the font is completely loaded and rejects when an error happens.
Specifications
Specification | Status | Comment |
---|---|---|
CSS Font Loading Module Level 3 The definition of 'FontFaceSet' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 35.0 | 41 (41) | ? | ? | ? |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | No support | 35.0 | 41.0 (41) | ? | ? | ? | ? | 35.0 |