WagtailFont Awesome 1.2.1

StreamField

像往常一样将FontAwesome图标添加到StreamField，只需设置icon=”fa-something”即可。参考完整列表。

例如，在一个类块中使用fa-exclamation-triangle

class NoticeBlock(StructBlock):
    message = RichTextBlock()
    indicator = ChoiceBlock()

    class Meta:
        icon = 'fa-exclamation-triangle'

相同的块，但内联

notice = StructBlock([
  ('message', RichTextBlock()),
  ('indicator', ChoiceBlock())
], icon='fa-exclamation-triangle')

使用IconBlock

Wagtail FontAwesome包含一个下拉选择器，您可以使用它从可用选项中选择一个块。例如，

from wagtailfontawesome.blocks import IconBlock

class CardBlock(StructBlock):
    icon = IconBlock()
    title = CharBlock()

您负责在自己的页面上自行包含FontAwesome CSS。有关使用Wagtail FontAwesome实现此操作的说明，请参阅下面的“前端”部分。

模型管理器

ModelAdmin 支持使用 Wagtail 1.5 或更高版本。类似于 StreamField，只需在您的菜单项上设置 icon="fa-something" 即可。

管理后台的其他部分

您可以使用以下方式在管理后台的任何位置包含图标

<i class="icon icon-fa-something"></i>

在 Wagtail 1.3.x 及以下版本中，您只能在页面编辑器屏幕上使用图标。

在前端

您还可以在前端包含 CSS，并遵循 FontAwesome 的文档。

{% load wagtailfontawesome %}

{% fontawesome_css %}

这将生成等效的标记，如下所示

<link rel="stylesheet" href="{% static 'wagtailfontawesome/css/fontawesome.css' %}">

然后，您可以使用以下方式在前端任何位置包含图标

<i class="fa fa-something"></i>

作为可选依赖项使用 wagtailfontawesome

如果您想分发包含 FontAwesome 图标的 Wagtail 插件，您可以通过检查它是否在 Django 中安装，并在未安装的情况下回退，以此作为可选依赖项使用此包。

from django.apps import apps
try:
    from wagtail.core.blocks import StructBlock
except ImportError:  # fallback for Wagtail <2.0
    from wagtail.wagtailcore.blocks import StructBlock


class BlockquoteBlock(StructBlock):
    quote = TextBlock()
    author = TextBlock()

    class Meta:
        if apps.is_installed('wagtailfontawesome'):
            icon = 'fa-quote-left'

（在这种情况下，回退操作是不执行任何操作）