digbang / font-awesome
Helper class to build FontAwesome icons
Installs: 24 415
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 22
Forks: 1
pkg:composer/digbang/font-awesome
Requires
- illuminate/support: ^5.1.3
Requires (Dev)
- phpspec/phpspec: ~2.0
This package is not auto-updated.
Last update: 2022-02-01 12:49:12 UTC
README
Helper class to create FontAwesome icons with a predefined markup.
Installation
Download through composer:
composer require digbang/font-awesome
Add the service provider and facade to your config/app.php
:
'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...
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...
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.
$fa = new Digbang\FontAwesome\FontAwesome; $fa->setTag('span'); $fa->icon('times', 'text-danger'); // <span class="fa fa-times text-danger"></span>