README

关于

此包是Spatie laravel-html包的扩展，用于轻松生成Font Awesome标记。

安装

您可以通过composer安装此包

composer require marvinlabs/laravel-html-font-awesome

如果您使用的是Laravel 5.5，服务提供者和外观将自动被发现。

在早期版本上，您需要手动执行此操作。

您必须安装服务提供者

// config/app.php
'providers' => [
    ...
    MarvinLabs\Html\FontAwesome\FontAwesomeServiceProvider::class,
];

并且可选地注册外观别名。

// config/app.php
'aliases' => [
    ...
    'FA' => MarvinLabs\Html\FontAwesome\Facades\FontAwesome::class,
];

使用

图标

以下是输出啤酒图标的两种等效方式。第一种允许完全自动补全。而第二种使用一点魔法，自动将方法名称转换为图标名称。

{!! fa()->icon('beer') !!}
{!! fa()->beer() !!}

当图标名称包含连字符（即 kebab case）时，您应该使用 camel case 相当物（删除连字符，并将第一个词之后的每个词首字母大写）。

{!! fa()->icon('window-close') !!}
{!! fa()->windowClose() !!}

如果您想使用Font Awesome 5提供的不同图标样式，您可以轻松地将样式参数添加到fa()中，或使用对应的图标样式的不同辅助器。（您也可以在配置文件中设置默认样式）

{!! fa('r')->icon('address-book') !!}
{!! far()->icon('address-book') !!}

修饰符

您可以链式调用方法来影响图标。

{!! fa()->icon('repeat')->spin()->size('2x') !!}

列表

您还可以轻松地将列表项目符号替换为自定义图标。

<ul class="fa-ul">
    <li>{!! fa()->checkSquareO()->forList() !!} Item 1</li>
    <li>{!! fa()->squareO()->forList() !!} Item 2</li>
    <li>{!! fa()->checkSquareO()->forList() !!} Item 3</li>
    <li>{!! fa()->checkSquareO()->forList() !!} Item 4</li>
</ul>

堆叠

您还可以生成图标堆叠（两个图标堆叠在一起）。

方法 stack 应该接收一个包含恰好两个项目的数组。项目可以是关联的，也可以不是。

如果传递简单字符串，则这些字符串被认为是图标名称。

{!! fa()->stack([ 'square-o', 'beer', ]) !!}

如果项目是 key => value 关联，则键被认为是图标名称，而值将是添加到图标元素的CSS类。

{!! fa()->stack([ 'square', 'beer' => 'fa-inverse', ]) !!}

项目也可以简单地通过链式调用方法创建，如上所述。

{!! fa()->stack([ 'square', fa()->icon('beer')->inverse()->flip(), ]) !!}

最后，您还可以向堆叠添加任何CSS类，如大小类（请参阅Font Awesome文档）。

{!! fa()->stack([ 'square-o', 'beer', ])->addClass('fa-5x') !!}

样式和脚本

使用maxCDN URL输出最新的最小化Font Awesome CSS链接

{!! fa()->css() !!}

变更日志

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

安全

如果您发现任何安全相关问题，请通过电子邮件发送到 bonjour@vincentprat.info，而不是使用问题跟踪器。

鸣谢

• Spatie agency 提供基本包

贡献者

• jyhsu2000（支持Font Awesome 5兼容性）

许可证

MIT许可证（MIT）。有关更多信息，请参阅 许可证文件