Smarty - die kompilierende PHP Template-Engine
Zurück	Kapitel 8. Eigene Funktionen	Nach vorne

{cycle} (Zyklus)

{cycle} wird verwendet um durch ein Set von Werten zu zirkulieren. Dies vereinfacht die Handhabung von zwei oder mehr Farben in einer Tabelle, oder um einen Array zu durchlaufen.

Attribut Name	Typ	Erforderlich	Standardwert	Beschreibung
name	string	Nein	default	Der Name des Zyklus.
values	mixed	Ja	N/A	Die Werte durch die zirkuliert werden soll, entweder als Komma separierte Liste (siehe 'delimiter'-Attribut), oder als Array.
print	boolean	Nein	true	Definiert ob die Werte ausgegeben werden sollen oder nicht.
advance	boolean	Nein	true	Definiert ob der nächste Wert automatisch angesprungen werden soll.
delimiter	string	Nein	,	Das zu verwendende Trennzeichen.
assign	string	Nein	n/a	Der Name der Template-Variable welcher die Ausgabe zugewiesen werden soll.
reset	boolean	No	false	Der Zyklus wird auf den ersten Wert zurückgesetzt.

Sie können durch mehrere Sets gleichzeitig iterieren, indem Sie den Sets einmalige Namen geben.

Um den aktuellen Wert nicht auszugeben, kann das 'print' Attribut auf 'false' gesetzt werden. Dies könnte sinnvoll sein, wenn man einen einzelnen Wert überspringen möchte.

Das 'advance'-Attribut wird verwendet um einen Wert zu wiederholen. Wenn auf 'false' gesetzt, wird bei der nächsten Iteration der selbe Wert erneut ausgegeben.

Wenn sie das spezielle 'assign'-Attribut übergeben, wird die Ausgabe der {cycle}-Funktion in dieser Template-Variable abgelegt, anstatt ausgegeben zu werden.

Beispiel 8-4. {cycle} (Zyklus)

{section name=rows loop=$data}
<tr bgcolor="{cycle values="#eeeeee,#d0d0d0"}">
   <td>{$data[rows]}</td>
</tr>
{/section}

<tr bgcolor="#eeeeee">
   <td>1</td>
</tr>
<tr bgcolor="#d0d0d0">
   <td>2</td>
</tr>
<tr bgcolor="#eeeeee">
   <td>3</td>
</tr>

Zurück	Zum Anfang	Nach vorne
{counter} (Zähler)	Nach oben	{debug}