dev-master
9999999-devLaravel helper for FontAwesome icons
MIT
The Requires
- php >=5.6.0
The Development Requires
by Joshua de Gier
Laravel helper for FontAwesome icons
The PendoNL/laravel-fontawesome
package provides an easy way to include FontAwesome icons in your code, there's even a Blade directive to use them inside your blade templates., (*2)
Make sure you've loaded FontAwesome's CSS on your page! This package only providers little helpers to generate icons!, (*3)
You can use the Facade to generate icons from within your code:, (*4)
FontAwesome::icon('arrow-up'); // Generates <i class="fa fa-arrow-up"></i>
It's also possible to add optional attributes for the icon:, (*5)
FontAwesome::icon('arrow-up', ['class' => 'tiny', 'id' => 'MyFirstIcon']); // Generates <i class="fa fa-arrow-up tiny" id="MyFirstIcon"></i>
If you aren't using the Facade, this is the way to generate an icon:, (*6)
use PendoNL\LaravelFontAwesome\LaravelFontAwesome; $fa = new LaravelFontAwesome(); $icon = $fa->icon('arrow-up', ['class' => 'tiny', 'id' => 'MyFirstIcon']);
And last, but not least, you there'a a blade directive to use inside your blade templates:, (*7)
@fa('arrow-up'); @fa('arrow-up', ['class' => 'tiny', 'id' => 'MyFirstIcon']);
Using the Facade from within your templates work as well:, (*8)
{!! FontAwesome::icon('building') !!} {!! FontAwesome::icon('building', ['id' => 'building-icon']) !}}
You can install the package via composer:, (*9)
``` bash composer require pendonl/laravel-fontawesome, (*10)
Next, you must install the service provider (For L5.5 and up Auto-Discovery is enabled): ```php // config/app.php 'providers' => [ ... PendoNL\LaravelFontAwesome\LaravelFontAwesomeServiceProvider::class, ];
Optionally, register the facade:, (*11)
// config/app.php 'aliases' => [ ... 'FontAwesome' => PendoNL\LaravelFontAwesome\Facade::class, ];
If you discover any security related issues, please email joshua@pendo.nl instead of using the issue tracker., (*12)
It was incredible helpfull to view various packages of Spatie to get to this final version. Aswel as lucasruroken/laravel-font-awesome
which I spotted and was the main reason to start creating my first package ever. Thanks both for open sourcing your packages! I also tried to write down this first experience on my companies blog, comments appreciated!, (*13)
Pendo is a webdevelopment agency based in Maastricht, Netherlands. If you'd like, you can visit our website., (*14)
The MIT License (MIT). Please see License File for more information., (*15)
Laravel helper for FontAwesome icons
MIT