depsimon / blade-fa5
Easily inline Font Awesome 5 icons in your Blade templates
Requires
- php: ^7.0
- illuminate/filesystem: ^5.3
- illuminate/support: ^5.3
This package is auto-updated.
Last update: 2024-11-22 22:34:56 UTC
README
Easily inline Font Awesome 5 icons in your Blade templates. Heavily inspired by the great [adamwathan/blade-svg].
Installation
You can install this package via Composer by running this command in your terminal in the root of your project:
composer require depsimon/blade-fa5
Getting started
Publish the Blade Font Awesome 5 config file:
php artisan vendor:publish --provider="Depsimon\BladeFa5\BladeFa5ServiceProvider"
Download the Font Awesome 5 latest version (Free or Pro) and put the SVG sprites in your public/svg
directory.
Configuration
Inside config/blade-fa5.php
, you can specify the spritesheets directory, the default weight and the default classes for icons.
<?php return [ 'spritesheets_url' => 'svg/', 'weight' => 'far', 'class' => 'icon inline-block fill-current', ];
Basic usage
You can insert an icon anywhere in your template with the @fa5
Blade directive.
You pass the name, then the weight, the classes and any additional classes:
@fa5('cog') @fa5('user', 'fas') <!-- Weight is "solid" --> @fa5('facebook', 'fab', 'text-blue') <!-- Weight is "brands" and apply "text-blue" class --> @fa5('spinner', 'fal', 'text-grey', ['spin']) <!-- Add the "spin" attribute -->
Credits
License
The MIT License (MIT). Please see License File for more information.