README

添加 Blade 指令
添加 Tabler 图标
添加 Bootstrap 图标
添加 Father 图标
添加 Material 图标

Blade Font Awesome

一个易于在您的 Laravel Blade 视图中使用 Font Awesome 的包。

有关可用的图标完整列表，请参阅 SVG 目录。

旧版本文档

您正在阅读 2.x 版本的文档。

如果您使用的是 Laravel 8 或以下版本，请参阅 1.x 版本的文档。

有关如何升级到最新版本的说明，请参阅升级指南。

要求

PHP 8.0 或更高版本
Laravel 9.x 或更高版本

安装

通过 Composer

composer require phyozawtun/blade-fontawesome

配置

Blade Font Awesome 还提供使用 Blade Icons 功能（如默认类、默认属性等）的能力。如果您想配置这些，发布 blade-fontawesome.php 配置文件

php artisan vendor:publish --tag=blade-fontawesome-config

用法

图标可以作为自闭合的 Blade 组件使用，这些组件将被编译为 SVG 图标

<x-fas-cloud/>

您也可以向图标组件传递类

<x-fas-cloud class="w-6 h-6 text-gray-500"/>

甚至可以使用内联样式

<x-fas-cloud style="color: #555"/>

图标集

注意：这些是特定图标集的默认前缀，这些都可以在 config/blade-fontawesome.php 文件中进行配置。

免费图标集

品牌 (fab)
常规 (far)
实心 (fas)

专业图标集

双色 (fad)
浅色 (fal)
细 (fat)
锐利 (fash)

原始 SVG 图标

如果您想将原始 SVG 图标作为资产使用，可以使用以下命令发布它们

php artisan vendor:publish --tag=blade-fontawesome --force

然后在您的视图中使用它们，如下所示

<img src="{{ asset('vendor/blade-fontawesome/solid/cloud.svg') }}" width="10" height="10"/>

Font Awesome Pro

Blade Font Awesome 支持使用 npm 下载的专业图标。

要使用此功能，请使用 npm i --save @fortawesome/fontawesome-pro 安装 Font Awesome Pro，然后运行以下 Artisan 命令将图标添加到您的 resources 路径。

php artisan blade-fontawesome:sync-icons --pro

Blade Font Awesome 将自动检测并使用位于 resources/icons/blade-fontawesome 路径下的专业图标。

Blade Icons

Blade Font Awesome 在底层使用 Blade Icons。有关附加功能，请参阅 Blade Icons 的 README。

变更日志

有关最近更改的更多信息，请参阅 CHANGELOG。

测试

composer test

贡献

有关详细信息，请参阅 CONTRIBUTING。

安全

如果您发现任何安全相关的问题，请通过电子邮件 security@voke.dev 反馈，而不是使用问题跟踪器。

鸣谢

许可协议

MIT 许可协议（MIT）。请参阅许可文件获取更多信息。

开源软件

您可以使用此软件包，但如果它被用于生产环境，您需要为世界种一棵树。

众所周知，种植树木是应对气候变化和防止气温上升超过1.5摄氏度的最佳工具之一。如果您支持此软件包并为开源森林做出贡献，您将为当地家庭创造就业机会并恢复野生动物栖息地。

您可以通过这里购买树木。

了解更多关于开源软件的信息请访问treeware.earth。

phyozawtun / blade-fontawesome

维护者

详细信息