README

此扩展为Contao CMS提供两个插入标签，用于创建Font Awesome图标。

功能

Font Awesome Inserttag同时支持Font Awesome 4和Font Awesome 5。

图标插入标签

有几个插入标签用于生成图标。对于Font Awesome 4，有之前已知的fa插入标签。为了支持Font Awesome 5引入的样式，有特定的插入标签样式fas、far、fal、fab。

以下选项受支持

• 第一个双列后的所有值都带有前缀fa-前缀：{{fa::phone}}

  <i class="fa fa-phone" aria-hidden="true"></i>

• 支持多个值：{{fa::phone 4x muted}}

  <i class="fa fa-phone fa-4x fa-muted" aria-hidden="true"></i>

• 可以传递其他值作为第二个参数，用冒号分隔：{{fa::phone 4x muted:pull-left custom}}

<i class="fa fa-phone fa-4x fa-muted pull-left custom" aria-hidden="true"></i>

双冒号 "::" 之间的旧语法已弃用但仍然支持。

与Font Awesome 5提供的新简码的工作方式相同。如果您从Font Awesome 4迁移到5并且有一些旧的插入标签，您可能需要查看提供的配置选项default_style。

插入标签 "fa-stack"

第二个插入标签支持Font Awesome的图标堆叠功能。上述所有功能都适用于每个图标。此外，图标堆叠包装器本身可以通过类进行调整

{fa-stack::square:first-icon::plus:secon-icon::lg:custom-stack}

  <span class="fa-stack fa-lg custom-stack"><i class="fa fa-square first-icon" aria-hidden="true"></i><i class="fa fa-plus second-icon" aria-hidden="true"></i></span>

为了支持Font Awesome 5引入的样式，有特定的插入标签样式fas-stack、far-stack、fal-stack、fab-stack。

要求

版本2是为Contao 4.4及以上版本设计的。它可以通过使用Contao的管理版本来安装。

如果您想自己添加捆绑包，只需将Netzmacht\Contao\FontAwesomeInsertTag\NetzmachtFontAwesomeInsertTagBundle添加到您的应用内核中。

配置

您可以在config.yml中覆盖用于图标或图标堆叠的模板。默认配置是

config:
  netzmacht_font_awesome_insert_tag:
    icon_template: '<i class="%%s" aria-hidden="true"></i>'
    stack_template: '<span class="fa-stack%%s">%%s%%s</span>'
    default_style: 'fa'

如果您从Font Awesome 4迁移到5，可能希望将默认样式设置为far或fas。