FontFaceSet

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 type loading is fired, indicating that a font face set has started to load.
FontFaceSet.onloadingdone
An EventListener property called whenever an event of type loadingdone is fired, indicating that a font face set has finished loading.
FontFaceSet.onloadingerror
An EventListener property called whenever an event of type loadingerror 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 No support 35.0 41.0 (41) ? ? ? ? 35.0
clear() method No support 48.0           48.0

 

Document Tags and Contributors

 Contributors to this page: jpmedley, teoli, Sebastianz
 Last updated by: jpmedley,