Smarty und die Template-Sprache nebeneinander #

Wenn Sie Smarty kennen, können Sie die meisten Templates von Exponential sofort lesen: Die geschweiften Klammern, das $, die Pipe und die Block-Tags folgen derselben Idee. Die Einzelheiten unterscheiden sich, und an den Einzelheiten scheitert ein Template. Diese Seite stellt beide nebeneinander. Die Spalte zu Smarty dient nur dem Vergleich und wurde hier nicht ausgeführt; jedes Beispiel der Template-Sprache wurde auf einer Entwicklungsinstallation gerendert.

Exponential führt Smarty-Templates selbst aus: Ein Design kann Smarty-5-Templates (.stpl) neben seinen .tpl-Templates enthalten, mit jedem Operator, jeder Fetch-Funktion, jeder Template-Funktion, jeder Override-Regel und jedem Cache des Template-Systems. Wenn Sie lieber weiter Smarty schreiben, lesen Sie Von .tpl zu .stpl umziehen und (Englisch) Smarty templates (.stpl) next to .tpl; die Konverter wandeln auch in beide Richtungen um.

Exponential führt Smarty-Templates selbst aus: Ein Design kann Smarty-5-Templates (.stpl) neben seinen .tpl-Templates enthalten, mit jedem Operator, jeder Fetch-Funktion, jeder Template-Funktion, jeder Override-Regel und jedem Cache des Template-Systems. Wenn Sie lieber weiter Smarty schreiben, lesen Sie Von .tpl zu .stpl umziehen und (Englisch) Smarty templates (.stpl) next to .tpl; die Konverter wandeln auch in beide Richtungen um.

Inhalt #

1. Die Tabelle
2. Ausgabe und Modifikatoren
3. Zuweisung und Standardwerte
4. Bedingungen und Schleifen
5. Include, literal, Begrenzer und Kommentare
6. Capture
7. Daten und Anzahlen
8. Verwandte Seiten

Die Tabelle #

Ausgabe und Modifikatoren #

Operatoren treten an die Stelle von Modifikatoren. Sie werden mit Klammern und durch Kommas getrennten Argumenten aufgerufen, nicht mit Doppelpunkten:

{def $title = '  The Exponential template language  '}
[{$title}]
[{$title|trim|upcase}]
[{$title|trim|shorten( 16 )}]
[{$title|trim|count_chars}]
[{'<b>bold</b> & more'|wash}]

Ausgabe:

[  The Exponential template language  ]
[THE EXPONENTIAL TEMPLATE LANGUAGE]
[The Exponenti...]
[33]
[<b>bold</b> & more]

shorten( 16 ) zählt die drei angehängten Punkte zu den 16 Zeichen. count_chars ist die Länge einer Zeichenkette.

Zuweisung und Standardwerte #

{def} legt eine Variable an und {set} ändert eine vorhandene; assign von Smarty tut beides. Ein Standardwert kommt von first_set, dem ersten gesetzten Parameter; cond ist der ternäre Ausdruck der Template-Sprache:

{def $name = 'Ada' $visits = 3}
{set $visits = $visits|inc}
{$name} has visited {$visits} times.
Nickname: {first_set( $nickname, 'none given' )}
Greeting: {cond( $visits|gt( 3 ), 'welcome back', 'hello' )}

Ausgabe:

Ada has visited 4 times.
Nickname: none given
Greeting: welcome back

Bedingungen und Schleifen #

if und foreach lesen sich fast gleich. Das Durchwechseln von Werten ist ein Parameter der Schleife (sequence), und ein Bereich wird for <erster> to <letzter> as $var geschrieben:

{def $count = 2}
{if $count|eq( 0 )}none{elseif $count|eq( 1 )}one{else}{$count} items{/if}
{foreach hash( 'a', 'apple', 'b', 'banana', 'c', 'cherry' ) as $key => $fruit sequence array( 'odd', 'even' ) as $row}
<li class="{$row}">{$key}: {$fruit}</li>
{/foreach}
{for 1 to 3 as $i}[{$i}]{/for}

Ausgabe:

2 items<li class="odd">a: apple</li><li class="even">b: banana</li><li class="odd">c: cherry</li>[1][2][3]

Die Zeilenumbrüche um jedes Funktions-Tag sind aus der Ausgabe verschwunden: Der Parser entfernt einen Zeilenumbruch vor und einen nach jedem Funktions-Tag (siehe Lexikalische Struktur). Smarty behält sie.

Include, literal, Begrenzer und Kommentare #

include nimmt eine uri, meist design:..., die die Design-Ressource über die Design-Basen und das Override-System auflöst. Dieses Beispiel bindet eine kleine eigene Datei mit der Ressource file: ein, sodass es außerhalb eines Designs läuft; die eingebundene Datei ist:

<p>Hello, {$who|wash}!</p>

und das Template, das sie einbindet, mit einem literal-Block, den beiden Begrenzerfunktionen und einem Kommentar:

{include uri='file:var/tmp/examples/tl-smarty/parts/greeting.tpl' who='designer'}
{* a comment is never output *}
{literal}<style>.box { color: red; }</style>{/literal}
{ldelim}not a tag{rdelim}

Ausgabe:

<p>Hello, designer!</p>

<style>.box { color: red; }</style>{not a tag}

Capture #

set-block rendert seinen Inhalt in eine Variable, wie capture von Smarty. Das Ergebnis ist eine gewöhnliche Zeichenkette, mit der Operatoren arbeiten können:

{set-block variable=badge}<span class="badge">{'new'|upcase}</span>{/set-block}
Captured {$badge|count_chars} characters: {$badge}

Ausgabe:

Captured 30 characters: <span class="badge">NEW</span>

Daten und Anzahlen #

Daten sind Zeitstempel; datetime( 'custom', <format> ) formatiert sie mit den Platzhaltern % des Locale-Codes, und l10n( 'shortdate' ) nutzt das kurze Datumsformat der aktuellen Locale:

{def $node = fetch( 'content', 'node', hash( 'node_id', 90 ) )}
Published: {$node.object.published|datetime( 'custom', '%Y-%m-%d' )}
Short date: {$node.object.published|l10n( 'shortdate' )}
Fields: {$node.data_map|count}

Ausgabe:

Published: 2023-01-25
Short date: 01/25/2023
Fields: 18

Verwandte Seiten #

• Von Exponential-Templates (.tpl) zu Exponential-Smarty-Templates (.stpl) umziehen: Smarty-Templates, von Exponential selbst ausgeführt
• Alle drei Engines, Twig eingeschlossen: Templates nebeneinander: Exponential-Templates, Twig und Smarty
• Zurück: Geschichte der Template-Sprache
• Weiter: Smarty und die Template-Sprache: die Unterschiede im Detail
• Ein Template von Smarty umziehen
• Grundlagen der TPL-Syntax
• Set-block und append-block
• Wash und Maskierung
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.