roelmagdaleno/php-heroicons

Render Heroicons from PHP.

1.0.0 2021-07-28 03:41 UTC

This package is not auto-updated.

Last update: 2021-10-22 20:11:48 UTC


README

A package to render Heroicons in your PHP application.

Preview the icons at heroicons.com, developed by Steve Schoger and Adam Wathan.

If you want to render Heroicons in your Laravel Blade views, use Blade Heroicons package.

Installation

Composer

composer require roelmagdaleno/php-heroicons

Usage

You can render a Heroicon using multiple ways:

Helper

Return the SVG by using the heroicon() helper function:

$text = heroicon('check-circle', ['width' => 60]);
echo "<p>My icon is: $text</p>";

Print the SVG directly:

echo heroicon('check-circle', ['width' => 60]);

Constructor

Instantiate an Icon class with parameters and print it directly:

use PHPHeroIcons\Icon;

echo new Icon('check-circle', ['width' => 60]);

Instantiate an Icon class with parameters and call the render() method.

use PHPHeroIcons\Icon;

$icon = new Icon('academic-cap', ['width' => 60]);
$icon->render();

Instantiate an Icon class with parameters and call the return() method.

use PHPHeroIcons\Icon;

$icon = new Icon('academic-cap', ['width' => 60]);
$text = $icon->return();

echo "<p>My icon is: $text</p>";

Render Method

If you want to render multiples icons and only use one Icon instance:

use PHPHeroIcons\Icon;

$icon = new Icon();

$icon->render('check-circle', ['width' => 60]);
$icon->render('academic-cap', ['width' => 60]);
$icon->render('library', ['width' => 60]);

Return Method

If you want to return multiples icons and only use one Icon instance:

use PHPHeroIcons\Icon;

$icon = new Icon();

$first  = $icon->return('check-circle', ['width' => 60]);
$second = $icon->return('academic-cap', ['width' => 60]);
$third  = $icon->return('library', ['width' => 60]);

echo "My first icon is: $first then use the $second and $third";

Parameters

The Icon constructor, heroicon(), render() and return() methods accepts these attributes in this order:

  • $icon
  • $attributes
  • $type

Example:

heroicon($icon, $attributes, $type);

The $icon accepts any Heroicon slug and if you insert an icon that doesn't exist it won't return anything.

For $attributes (optional) you can pass only these attributes as array key/value format:

  • width
  • height
  • class
  • id

If you pass an attribute that is not listed previously it won't be attached to the SVG HTML.

And last, but not least, you can specify the Heroicon $type:

  • solid
  • outline

By default the icons will be printed in solid type.

Example:

heroicon(
    'library',
    [
        'width'  => 60,
        'height' => 60,
        'class'  => 'my-custom-css-class',
        'id'     => 'my-custom-id',
    ]
); // Print solid icon with multiple attributes.

heroicon(
    'check-circle',
    [
        'width'  => 60,
        'height' => 60,
        'class'  => 'my-custom-css-class',
        'id'     => 'my-custom-id',
    ],
    'outline'
); // Print outline icon with multiple attributes.

Examples

For more usage examples visit the examples/index.php file.