This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
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
FontFaceobject, built from an external resource described by an URL or from anArrayBuffer.
Properties
This interface doesn't inherit any property.
FontFace.family- Is a
DOMStringthat contains the family of the font. It is equivalent to thefamilydescriptor. FontFace.style- Is a
DOMStringthat contains the style of the font. It is equivalent to thestyledescriptor. FontFace.weight- Is a
DOMStringthat contains the weight of the font. It is equivalent to theweightdescriptor. FontFace.stretch- Is a
DOMStringthat contains how the font stretches. It is equivalent to thestretchdescriptor. FontFace.unicodeRange- Is a
DOMStringthat contains the range of code encompassed the font. It is equivalent to theunicode-rangedescriptor. FontFace.variant- Is a
DOMStringthat contains the variant of the font. It is equivalent to therangedescriptor. FontFace.featureSettings- Is a
DOMStringthat contains the features of the font. It is equivalent to thefeature-settingsdescriptor. FontFace.statusRead only- Returns an enumerated value indicating the status of the font. It can be one of the following:
"unloaded","loading","loaded", or"error". FontFace.loadedRead only- Returns a
Promiseto aFontFacethat 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
Promiseto aFontFacethat 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 |