{cycle} は、値の設定に従って循環します。
テーブル内のセルの色を交互に2色もしくはそれ以上の色に変更したり、
配列の値を循環するような事が簡単に行えます。
| 属性名 | 型 | 必須 | デフォルト | 概要 |
|---|---|---|---|---|
| name | string | No | default | サイクルの名前 |
| values | mixed | Yes | N/A | カンマを境界としたリスト (delimiter属性を参照) または値の配列のどちらかによって指定する、循環される値 |
| boolean | No | TRUE |
値を表示するかどうか | |
| advance | boolean | No | TRUE |
次の値に進むかどうか |
| delimiter | string | No | , | value 属性で使用するためのデリミタ |
| assign | string | No | n/a | 出力が割り当てられるテンプレート変数 |
| reset | boolean | No | FALSE |
次の値に進まずに、最初の値をセットする。 |
name 属性を渡す事によって、テンプレート内で
1つ以上の値のセットを通して {cycle} を行えます。
各 {cycle} にはユニークな name
を与えてください。
print 属性に FALSE をセットする事で、
強制的に現在の値を表示しない事が可能です。これは、
こっそり値をスキップするのに役に立つでしょう。
advance 属性は値を繰り返すために使われます。
FALSE をセットした時に次の {cycle} が呼ばれると、
同じ値を表示します。
assign 属性を指定した場合は、
{cycle} 関数の出力は
テンプレートに出力される代わりにテンプレート変数に割り当てられます。
Example 8.5. {cycle}
{section name=rows loop=$data}
<tr class="{cycle values="odd,even"}">
<td>{$data[rows]}</td>
</tr>
{/section}
上のテンプレートの出力
<tr class="odd"> <td>1</td> </tr> <tr class="even"> <td>2</td> </tr> <tr class="odd"> <td>3</td> </tr>