armin/font-awesome-bundle

Symfony 扩展,提供 Font Awesome svg 图标作为内联 svg 精灵。

安装: 291

依赖者: 0

建议者: 0

安全: 0

星级: 0

观察者: 1

分支: 1

开放问题: 3

类型:symfony-bundle

1.0.0 2020-04-29 11:27 UTC

README

此包适用于 Symfony 框架,允许您在 HTML 中添加 FontAwesome SVG 图标。

该软件采用 MIT 许可证发布。

安装

要安装此包,您可以使用 composer

$ composer require armin/font-awesome-bundle

这还将需要 fortawesome/font-awesome 包。

请确保,您已正确地在项目的 config/bundles.php 中注册了此包。无需进行配置。

功能

  • 将 FontAwesome svg 图标嵌入到我们的 HTML 输出中
  • 无需包含任何 CSS 或 JavaScript
  • 使用 SVG 精灵
    • 当同一图标在同一页面上被多次使用时(例如箭头图标),该图标每个额外实例将指向 HTML 输出中的第一次出现
    • 每个实例都可以有单独的选项,如大小或颜色
    • 这节省了 HTML 输出中的空间
  • 无需从 vendor/ 复制/symlink SVG 资产到 public/

用法

一旦安装了此包,您可以使用以下 Twig 函数

 {{ fa("smile-beam") }} == {{ fa("fas smile-beam") }}
 {{ fa("far smile-beam") }}
 {{ fa("far smile-beam", {size: 256, color: '#d50', class: 'card shadow'}) }}

建议添加一些默认 CSS。所有图标在 HTML 输出中都将设置类 fa-svg-icon

.fa-svg-icon {
  width: 32px;
  height: 32px;
  fill: #444;
}

当您提供选项,如大小或颜色时,内联样式将覆盖默认 CSS。

支持

如果您喜欢这个 Symfony 扩展,请邀请您 捐款 以支持进一步的开发。谢谢!

如有帮助,请访问 Github 上的问题部分。