{cycle}

{cycle}

{cycle} is used to cycle though a set of values. This makes it easy to alternate for example between two or more colors in a table, or cycle through an array of values.

Attribute NameTypeRequiredDefaultDescription
namestringNodefaultThe name of the cycle
valuesmixedYesN/AThe values to cycle through, either a comma delimited list (see delimiter attribute), or an array of values.
printbooleanNotrueWhether to print the value or not
advancebooleanNotrueWhether or not to advance to the next value
delimiterstringNo,The delimiter to use in the values attribute.
assignstringNon/athe template variable the output will be assigned to
resetbooleanNofalseThe cycle will be set to the first value and not advanced

You can {cycle} through more than one set of values in your template by supplying a name attribute. Give each set of values a unique name.

You can force the current value not to print with the print attribute set to false. This would be useful for silently skipping a value.

The advance attribute is used to repeat a value. When set to false, the next call to {cycle} will print the same value.

If you supply the special "assign" attribute, the output of the cycle function will be assigned to a template variable instead of being output to the template.

Example 8-4. {cycle}

{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>
© Copyright 2003-2023 www.php-editors.com. The ultimate PHP Editor and PHP IDE site.