This library is deprecated and no longer maintained. The CSS font loading API is near impossible to implement without access to the browser's internal font loading behaviour. The most useful aspects of the API (font events) has been implemented in Font Face Observer, so please use that instead.
If you using npm:
$ npm install fontloader
Otherwise copy the fontloader.js file to your project and include it.
Metric compatible fonts
Metric compatible fonts are fonts that are designed to have identical metrics to another font so they can be used as a substitute without affecting page layout. When a web font is metric compatible with one of the system fonts (the fonts that are used for
monospace) the fontloader can not detect when the web font has loaded.
Slow loading fonts
The library has a default timeout of 3 seconds after which it considers a font "load" failed. Unlike the native API this library is not capable of cancelling in-progress font loads so it may happen that the font still loads after the timeout. This is a rare case and usually indicative of a problem with either the font or the host it is loaded from.
The following browsers are supported:
Other browser may work, but are not extensively tested. Please open an issue if you think a browser should be supported but isn't. Tests are run automatically on all supported browsers using BrowserStack and browserstack-test.
Copyright and License
Portions of this project are derived from the Web Font Loader:
Web Font Loader Copyright (c) 2010 Adobe Systems Incorporated, Google Incorporated.
The FontLoader polyfill is therefore also licenced under the Apache 2.0 License:
FontLoader Polyfill Copyright (c) 2013-2014 Bram Stein
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.