This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The FontFaceSet
interface of the CSS Font Loading API manages the loading of font-faces and querying of their download status.
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
called whenever an event of typeloading
is fired, indicating a font-face set has started loading. FontFaceSet.onloadingdone
- An
EventListener
called whenever an event of typeloadingdone
is fired, indicating that a font face set has finished loading. FontFaceSet.onloadingerror
- An
EventListener
called whenever an event of typeloadingerror
is fired, indicating that an error occurred whilst loading a font-face set.
Methods
FontFaceSet.add()
- Adds a font to the font set.
FontFaceSet.check()
- A
Boolean
that indicates whether a font is loaded, but doesn't initiate a load when it isn't. FontFaceSet.clear()
- Removes all fonts from the font set.
FontFaceSet.delete()
- Removes a font from the font set.
FontFaceSet.load()
- Returns a
Promise
which resolves to a list of font-faces for a requested font. FontFaceSet.ready()
- Returns a
Promise
which resolves once font loading and layout operations have completed.
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) | ? | ? | 10 |
clear() method | 48.0 |
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) | ? | ? | ? | 10 | 35.0 |
clear() method | No support | 48.0 | 48.0 |