bugo / fa-php-helper
获取FontAwesome图标HTML代码的帮助类
0.4
2024-05-23 04:54 UTC
Requires
- php: ^8.1
- nette/utils: ^4.0
Requires (Dev)
- pestphp/pest: ^2.33.4
- rector/rector: ^1.0
README
描述
本包旨在生成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());