This repo is discontinued - for Latte3 and PHP8.1 you should look here: https://github.com/kravcik/latte-font-awesome-icon

Simple macro for generating Font Awesome icons. First parameter is required. Parameters can be set in order or randomly with string keys (macro detects if it's getting an associative array).

It's compatible with FontAwesome 5, but default style is set to light. Best option would be to create multiple macros or a static variable to set default style. Send me a PR or create an issue if you need this.

Thanks to @peldax it's also possible to change the html element. Default is span.

latte:
    macros:
        - Kravcik\Macros\FontAwesomeMacro::install

1. icon - icon name without fa-
2. color - color (blue, red-dark, etc.)
3. size - number (generates fa-{size}x) or sm, lg, etc.
4. fw - if TRUE, disable fa-fw
5. style - fas / far / fal / fab

{icon star, 'el' => 'i'} -> <i class="fal fa-star fa-fw"></i>

{icon star} -> <span class="fal fa-star fa-fw"></span>

{icon star, red} -> <span class="fal fa-star color-red fa-fw"></span>

{icon star, NULL, lg} -> <span class="fal fa-star fa-lg fa-fw"></span>

{icon star, yellow, 2} -> <span class="fal fa-star color-yellow fa-2x fa-fw"></span>

{icon star, blue, 2, TRUE, far} -> <span class="far fa-star color-blue fa-2x"></span>

{icon star, size => 2, fw => TRUE, color => 'green-light', style => 'fas'} -> <span class="fas fa-star color-green-light fa-2x"></span>