This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use 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 spec changes.
The
load() method of the FontFaceSet forces all the fonts given in parameters to be loaded.Syntax
result = aFontFaceSet.load(font); result = aFontFaceSet.load(font, text);
Returns
A Promise of an Array of FontFace loaded. The promise is fulfilled when all the fonts are loaded; it is rejected if one of the fonts failed to load.
Parameters
font: a font specification using the CSS value syntax, e.g. "italic bold 16px Roboto"text: limit the font faces to those whose Unicode range contains at least one of the characters in text. This does not check for individual glyph coverage.
Examples
// returns a promise that will be fulfilled or rejected according the success to load MyFont
// The code in 'then' can assume the availability of that font.
document.fonts.load("12px MyFont", "ß").then(…);
Specifications
| Specification | Status | Comment |
|---|---|---|
| CSS Font Loading Module Level 3 The definition of 'load' 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 | Not supported | 35.0 | 41.0 (41) | ? | ? | ? | ? | 35.0 |