Twig-Templates haben ihre eigene Syntax. Wir stellen hier nur die wichtigsten Regeln vor, die zum Grundverständnis von Twig notwendig sind.
Die Twig Syntax ist gut dokumentiert. Als Startpunkt ist der Abschnitt Twig für Template-Designer zu empfehlen.
In Twig werden folgende drei Bezeichner verwendet
{# ... #}
- Kommentare{{ ... }}
- Variable ausgeben{% ... %}
- Kommandos und KontrollstrukturenEin Kommentar kann ein- oder mehrzeilig sein. Alles was zwischen {#
und #}
steht, wird auskommentiert.
{# mein Kommentar #}
Es ist auch möglich Teile des Code auszukommentieren.
{# auskommentierter Code - der Code wird nicht ausgeführt
{{ variable }}
#}
Eine Variable kannst du mit {{ name_der_variablen }}
ausgeben.
<p>Ausgabe: {{ name_der_variablen }} </p>
Hierunter versteht man im weitesten Sinn alles, was im Zusammenhang mit der Steuerung bei der Ausgabe von Variablen verbunden ist. Hier werden nur die gängigsten vorgestellt, die häufig auch in Contao-Templates verwendet werden.
Wenn bestimmte Ausgaben nur dann erfolgen sollen, wenn eine Bedingung erfüllt ist, verwendest du die If-Abfrage.
{% if meine_variable %}
<p>Die Variable hat folgenden Inhalt:</p>
<p>{{ meine_variable }}</p>
{% endif %}
Eine For-Schleife wird verwendet, um Code wiederholt auszuführen. Ein typisches Anwendungsbeispiel ist die Ausgabe von Inhalten eines Arrays.
<ul>
{% for item in items %}
<li>{{ item }}</li>
{% endfor %}
</ul>
Filter werden auf Variable angewendet. Sie geben an wie eine Variable verarbeitet werden soll.
{{ name der variable|name_des_filters }}
Filter in Twig sind extrem leistungsfähig und vielseitig. Twig bringt viele
Filter von Haus aus mit. Entwickler können aber auch eigene
Filter erstellen.
Wer sich für die Erstellung eigener Filter interessiert schaut bitte in die
Entwicklerdokumentation.
Du möchtest etwas ausprobieren? Dazu kannst du Twig fiddle verwenden.