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 FontFaceSet
interface of the CSS Font Loading API is an interface for loading font faces and checking their download statuses.
Properties
FontFaceSet.status
Read only- Indicates the font face's loading status. It will be one of
'loading'
or'loaded'
.
Events
FontFaceSet.onloading
- An
EventListener
property called whenever an event of typeloading
is fired, indicating that a font face set has started to load. FontFaceSet.onloadingdone
- An
EventListener
property called whenever an event of typeloadingdone
is fired, indicating that a font face set has finished loading. FontFaceSet.onloadingerror
- An
EventListener
property called whenever an event of typeloadingerror
is fired, indicating that an error occurred during the loading of a font face set.
Methods
FontFaceSet.add()
- Adds a font to the the font set.
FontFaceSet.check()
- A boolean that indicates wether a font is loaded but does not initiate a load when it is not.
FontFaceSet.clear()
- Removes all fonts from the font set.
FontFaceSet.delete()
- Removes a font from the font set.
FontFaceSet.load()
- Returns a
Promise
resolving to a list of font faces for a requested font. FontFaceSet.ready()
- Returns a
Promise
indicating that font loading and layout operations are done
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) | ? | ? | ? |
clear() method | 48.0 |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|
Basic support | Not supported | 35.0 | 41.0 (41) | ? | ? | ? | ? | 35.0 |
clear() method | Not supported | 48.0 | 48.0 |