在整个文档中，您可能已经注意到，在我们的示例中引用YAML字段时，使用了 |e 和 |raw 等Twig过滤器。这里有一个简单的例子:

{% if particle.headline %}<h1 class="font-family-bloody">{{ particle.headline|raw }}</h1>{% endif %}

这句话来自我们关于添加和应用字体的指南。它检测一个粒子的标题字段是否有一个集合值，如果是，则以原始的HTML格式显示它。

这允许用户输入HTML，例如style="color:red" Title style。并且让它在前端呈现红色标题而不是被翻译成文字字符。

在Gantry中，默认情况下这些元素会被转义。这是一种安全预防措施，因为它只将这些字段的内联HTML限制在您有意启用的字段中。如果您想为一个字段打开呈现的HTML，您需要添加|raw 过滤器。

有用的资源

广泛的Twig文档覆盖了广泛的过滤器。我们只报道了在Twig官方支持的30多个国家。

您甚至可以找到关于每个过滤器的更详细的文档，包括如何以及何时使用它。我们建议从阅读关于escape和raw的阅读开始，因为这些在我们的文档中经常用到，在Hydrogen主题中也是如此。

自定义Twig过滤器

Gantry 5包括一组不同的Twig过滤器，它们是Gantry的习惯。它们使您能够从Gantry中获得更多，并利用其强大的特性。

例子

fieldname

Input (Twig):

<input type="text" name="{{ 'particles.date.format'|fieldName }}"/>

Output (HTML):

<input type="text" name="particles[date][format]"/>

html

Input (Twig):

{{ '<img src="gantry-theme://images/foo.jpg"/>'|html }}

Output:

<img src="/templates/g5_hydrogen/images/foo.jpg"/>

url

Input (Twig):

<img src="{{ 'gantry-theme://images/foo.jpg'|url }}"/>

Output (HTML):

<img src="/templates/g5_hydrogen/images/foo.jpg"/>

trans

Input (Twig):

<h1>{{ 'GANTRY5_PLATFORM_STYLES'|trans }}</h1>

Output (HTML):

<h1>Styles</h1>

repeat

Input (Twig):

{{ '.'|repeat(3) }}

Output (HTML):

...

values

Input (Twig):

{% set array = {one: 'foo', two: 'bar'} %}
{% set values = array|values %}
{{ array|json_encode }} => {{ values|json_encode }}

Output (HTML):

{"one":"foo",""two":"bar"} => ["foo","bar"]

imagesize

Input (Twig):

<img src="{{ 'gantry-theme://images/foo.jpg'|url }}" {{ 'gantry-theme://images/foo.jpg'|imagesize }}/>

Output (HTML):

<img src="/templates/g5_hydrogen/images/foo.jpg" width="100" height="50" />

自定义Twig功能

和Twig filter一样，Gantry 5也有一组定制的Twig函数，可以在模板和粒子中使用。下面是一个快速列表: