digbang/font-awesome

Helper class to build FontAwesome icons

Digbang/FontAwesome

, _(*1)

Helper class to create FontAwesome icons with a predefined markup., _(*2)

Installation

Download through composer:, _(*3)

composer require digbang/font-awesome

Add the service provider and facade to your config/app.php:, _(*4)

'providers' => [
    // ...
    Digbang\FontAwesome\FontAwesomeServiceProvider::class,

],

'aliases' => [
    // ...
    'FontAwesome' => Digbang\FontAwesome\Facade::class,
],

Usage

Through the facade

FontAwesome::icon('icon', 'extra-class') // <i class="fa fa-icon extra-class"></i>
// or...
FontAwesome::icon('icon', ['class' => 'extra-class']) // <i class="fa fa-icon extra-class"></i>

Through the helper function

fa('icon', 'extra-class') // <i class="fa fa-icon extra-class"></i>
// or...
fa('icon', ['class' => 'extra-class']) // <i class="fa fa-icon extra-class"></i>

HTML Attributes

You can also add any other attributes to the html. Doing..., _(*5)

fa('times', ['title' => 'Delete this!']) // <i class="fa fa-times" title="Delete this!"></i>

Changing the tag

You can change the tag used by the library. Doing..., _(*6)

FontAwesome::setTag('span');

fa('edit'); // <span class="fa fa-edit"></span>

Standalone usage

Non-Laravel projects can still use this, but the Facade and helper function won't be available., _(*7)

$fa = new Digbang\FontAwesome\FontAwesome;
$fa->setTag('span');
$fa->icon('times', 'text-danger'); // <span class="fa fa-times text-danger"></span>