Skip to content

idleberg/fontawesome-svg-loader

Repository files navigation

fontawesome-svg-loader

npm npm CI

Loads Font Awesome SVG icons and inlines them in place of the default markup

Demo Time 🙌

Installation

npm install fontawesome-svg-loader -S

Usage

Include script and stylesheet in your website

<!-- Loader script -->
<script src="https://cdn.jsdelivr.net/npm/fontawesome-svg-loader@latest/dist/fontawesome-svg-loader.js"></script>

<!-- Fallback when JavaScript is not available -->
<noscript>
  <link
    href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5/css/all.min.css"
    rel="stylesheet"
  />
</noscript>

Next, you need to invoke the script

document.addEventListener('DOMContentLoaded', function() {
  awesomeLoader.init()
});

Use the Font Awesome markup like you usually would, the library will take care of the rest

<i class="fas fa-feather-alt"></i>

Options

options.url

Type: string

Provide URL from where to load Font Awesome v5. Defaults to jsDelivr.

⚠️ It's encouraged to use a specific version in the jsDelivr URL to get longer cache expiration times

options.fetch

Type: object

Options for fetch(), see MDN for details. Defaults to {"cache": "force-cache"}.

Browser Support

This library supports all modern browsers. You will need to BYOP (”Bring your own Polyfills”) to get it working in old browsers.

⚠️ Keep in mind that using polyfills can result in slower load-times compared to the standard Font Awesome usage

License

This work is licensed under The MIT License