Steueroperatoren #

cond und first_set sind die Antwort der Template-Sprache auf einen ternären Ausdruck (a ? b : c) und einen Null-Koaleszenz-Ausdruck (a ?? b). Beide werden von eZTemplateControlOperator (lib/eztemplate/classes/eztemplatecontroloperator.php) über lib/eztemplate/classes/eztemplateautoload.php registriert. Keiner der beiden nimmt eine gepipte Eingabe oder benannte Parameter entgegen; beide werten ihre Parameter verzögert von links nach rechts aus und hören auf, sobald sie eine Antwort haben. Der Compiler macht aus beiden verschachtelte PHP-if-Blöcke (condTransform()), sodass sie in einem kompilierten Template keinen Operatoraufruf kosten.

Inhalt #

1. cond
2. first_set
3. Verwandte Seiten

cond #

cond #

Nimmt Parameterpaare aus Bedingung und Wert entgegen. Gibt den Wert des ersten Paares zurück, dessen Bedingung wahr ist. Ein ungerader letzter Parameter ist der Standardwert, der verwendet wird, wenn keine Bedingung zutraf. Mit einem einzigen Parameter gibt er diesen Parameter zurück.

Eingabe: keine. Gibt den gewählten Wert zurück oder nichts, wenn keine Bedingung zutraf und es keinen Standardwert gibt. Generierte Referenz: cond.

{def $node = fetch( 'content', 'node', hash( 'node_id', 144 ) )}
{cond( $node.children_count|gt( 10 ), 'many', $node.children_count|gt( 0 ), 'some', 'none' )} children ({$node.children_count})
{cond( false(), 'never', 'the default' )}
{cond( 'only one parameter' )}

Ausgabe:

many children (18)
the default
only one parameter

Eine häufige Verwendung ist ein Klassenattribut in einer Schleife, hier bei den Kindern der Startseite von Fit & Healthy (Knoten 89):

{foreach fetch( 'content', 'list', hash( 'parent_node_id', 89, 'limit', 4, 'sort_by', array( 'priority', true() ) ) ) as $i => $child}
<li class="{cond( $i|eq( 0 ), 'first', $child.class_identifier|eq( 'ng_topic' ), 'topic', 'item' )}">{$child.name|wash}</li>
{/foreach}

Ausgabe:

<li class="first">Fitness</li><li class="topic">Workout</li><li class="item">Fit &amp; Healthy site info - [SITEINFO]</li><li class="item">Tour</li>

Ein Standardwert, der selbst falsch ist. Der Interpreter (modify()) wertet den Standardwert wie eine Bedingung aus und verwendet ihn nur, wenn er wahr ist; ein Standardwert 0, '' oder false() ergibt also nichts. Die kompilierte Form weist den Standardwert zu, ohne ihn zu prüfen. Das folgende Beispiel wurde vom Interpreter gerendert:

[{cond( false(), 'x', 0 )}]

Ausgabe:

[]

Kompiliert auf einer Entwicklungsinstallation, wo das Kompilieren von Templates aktiviert ist, gab dieselbe Zeile [0] aus.

Ausgabe mit dem Template-Compiler (in einen Arbeitsordner kompiliert):

[0]

Für ein verlässliches 0 prüfen Sie den Fall ausdrücklich: cond( $x, 'x', true(), 0 ).

first_set #

first_set #

Gibt den ersten Parameter zurück, der gesetzt ist, also nicht null. Nicht definierte Variablen und fehlende Hash-Schlüssel sind hier erlaubt und protokollieren nichts (der Interpreter fragt sie mit der Existenzprüfung von elementValue() ab, der kompilierte Code verwendet isset()). Ist keiner gesetzt, gibt er null zurück. Ein konstanter Parameter beendet im kompilierten Code die Suche; setzen Sie den literalen Ersatzwert daher an das Ende.

Eingabe: keine. Gibt den ersten Wert zurück, der nicht null ist. Beachten Sie, dass 0, '' und false als gesetzt gelten. Generierte Referenz: first_set.

{def $view_parameters = hash( 'offset', 20 )}
offset = {first_set( $view_parameters.offset, 0 )}
limit = {first_set( $view_parameters.limit, $undefined_limit, 10 )}
title = {first_set( $no_such_variable, 'Untitled' )}

Ausgabe:

offset = 20
limit = 10
title = Untitled

So liest man üblicherweise einen optionalen Parameter eines eingebundenen Templates oder einen optionalen Ansichtsparameter wie $view_parameters.offset.

Verwandte Seiten #

• cond und first_set für Designer
• Logische Operatoren: choose, and, or
• Variablen und def: default für optionale Parameter von include
• Alle Template-Operatoren (generiert)
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.