FontFaceSet.load()
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
JavaScript
Copy Code
<var>result</var> = <var>aFontFaceSet</var>.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
JavaScript
Copy Code
// 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 |
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/fontfaceset/load