Twig Filter und Funktionen

In dieser Dokumentation haben Sie vielleicht bemerkt, dass Zweigfilter wie |e und |raw verwendet werden, wenn wir in unseren Beispielen auf YAML-Felder verweisen. Hier ist ein kurzes Beispiel:

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

Diese Zeile stammt aus unserem Leitfaden zum Hinzufügen und Anwenden von Schriften. Es erkennt, ob das Headline-Feld eines Partikels einen eingestellten Wert hat, und wenn ja, zeigt es es in seinem rohen HTML-Format an.

Dies ermöglicht es dem Benutzer, HTML wie < style="color:red">Titel einzugeben und einen roten Titel am Frontend anzuzeigen, anstatt in seine literalen Zeichen übersetzt zu werden.

In Gantry werden diese Elemente standardmäßig escaped. Dies ist eine Sicherheitsvorkehrung, da es Inline-HTML aus diesen Feldern nur auf Felder beschränkt, für die Sie es absichtlich aktiviert haben. Wenn Sie gerendertes HTML für ein Feld öffnen möchten, müssen Sie den Filter |raw hinzufügen.

Hilfreiche Ressourcen

Die umfangreiche Twig-Dokumentation von SensioLabs umfasst Filter umfassend. Wir haben nur ein paar der über 30 offiziell in Twig unterstützten Personen abgedeckt.

Sie werden noch detailliertere Dokumentationen zu jedem Filter finden, einschließlich der Frage, wie und wann er verwendet wird. Wir empfehlen, mit der Lektüre über Flucht und Rohmaterial zu beginnen, da diese sowohl in unserer Dokumentation als auch im Hydrogen Theme häufig verwendet werden.

Benutzerdefinierte Twigfilter

Gantry 5 beinhaltet eine Reihe von verschiedenen Twig-Filtern, die speziell auf Gantry zugeschnitten sind. Sie ermöglichen es Ihnen, mehr aus Gantry herauszuholen und einige der leistungsstarken Funktionen zu nutzen.

Beispiele

Feldname

Input (Twig):

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

Output (HTML):

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

html

Input (Twig):

{{ '<img src="/"/>'|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" />

Benutzerdefinierte Twig-Funktionen

Genau wie bei Twig Filters - Gantry 5 hat auch eine Reihe von benutzerdefinierten Twig-Funktionen, die Sie in Vorlagen und Partikeln verwenden können. Hier ist eine kurze Liste: