Web Font Loader

Web Font Loader Copyright (c) 2010 Adobe Systems Incorporated, Google Incorporated.

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

http://www.apache.org/licenses/LICENSE-2.0

To use the Web Font Loader library, just include it in your page and tell it which fonts to load. For example, you could load fonts from Google Fonts using the Web Font Loader hosted on Google Hosted Libraries using the following code.

<script src="//ajax.googleapis.com/ajax/libs/webfont/1.4.7/webfont.js"></script>

<script>

WebFont.load({

google: {

families: ['Droid Sans', 'Droid Serif']

}

});

</script>

Web Font Loader provides an event system that developers can hook into. It gives you notifications of the font loading sequence in both CSS and JavaScript.

loading - This event is triggered when all fonts have been requested.

active - This event is triggered when the fonts have rendered.

inactive - This event is triggered when the browser does not support linked fonts or if none of the fonts could be loaded.

fontloading - This event is triggered once for each font that's loaded.

fontactive - This event is triggered once for each font that renders.

fontinactive - This event is triggered if the font can't be loaded.

The Web Font Loader configuration is defined by a global variable named WebFontConfig, or passed directly to the WebFont.load method. It defines which fonts to load from each web font provider and gives you the option to specify callbacks for certain events. When using the asynchronous approach, you must define the global variable WebFontConfig before the code that loads the Web Font Loader

Web Font Loader gives you added control when using linked fonts via @font-face.