bugo/fa-php-helper

获取FontAwesome图标HTML代码的帮助类

0.4 2024-05-23 04:54 UTC

This package is auto-updated.

Last update: 2024-09-16 18:35:16 UTC


README

PHP Coverage

俄语

描述

本包旨在生成FontAwesome 6图标的CSS类和HTML代码。此外,还提供以下功能:

  • 添加图标颜色
  • 调整图标大小
  • 支持现代(fa-solid fa-)和已弃用(fas fa-)类。
  • 使用固定宽度图标(fa-fw)在列表中显示
  • 可选地添加aria-hidden="true"属性以隐藏图标供屏幕阅读器等使用
  • 获取随机图标的CSS类
  • 所有图标的CSS类集合

安装

composer require bugo/fa-php-helper

使用

如果只需要CSS类

<?php

use Bugo\FontAwesome\Enums\Icon;

// 'fa-solid fa-user'
echo Icon::V6->solid('user');

// 'fa-regular fa-user'
echo Icon::V6->regular('user');

// 'fa-brands fa-windows'
echo Icon::V6->brand('windows');

高级示例

<?php

use Bugo\FontAwesome\Enums\Icon;

$icon = Icon::V5->brand('windows');

// 'fab fa-windows fa-fw text-red-500'
var_dump(
    $icon
        ->fixedWidth()
        ->color('text-red-500')
        ->text()
);

$icon = Icon::V6->solid('user');

// '<i class="fa-solid fa-user fa-2xl" style="color:red" title="Пользователь" aria-hidden="true"></i>'
var_dump(
    $icon
        ->color('red')
        ->size('2xl')
        ->title('Пользователь')
        ->ariaHidden()
        ->html()
);

可以通过addClass方法传递额外的类

<?php

use Bugo\FontAwesome\Enums\Icon;

$icon = Icon::V6->solid('heart');

// '<i class="fa-solid fa-heart fa-beat"></i>'
var_dump(
    $icon
        ->addClass('fa-beat')
        ->html()
);

您也可以获取一个随机图标

<?php

use Bugo\FontAwesome\Enums\Icon;

var_dump(Icon::V6->random());

这样您就可以一次性获取包含所有CSS类的整个集合

<?php

use Bugo\FontAwesome\Enums\Icon;

var_dump(Icon::V6->collection());