.. include:: ../../../Includes.txt

.. _typo3fluid-fluid-cycle:

=====
cycle
=====


This ViewHelper cycles through the specified values.
This can be often used to specify CSS classes for example.
**Note:** To achieve the "zebra class" effect in a loop you can also use the "iteration" argument of the **for** ViewHelper.

Examples
========

Simple::

   <f:for each="{0:1, 1:2, 2:3, 3:4}" as="foo"><f:cycle values="{0: 'foo', 1: 'bar', 2: 'baz'}" as="cycle">{cycle}</f:cycle></f:for>

Output::

   foobarbazfoo

Alternating CSS class::

   <ul>
   <f:for each="{0:1, 1:2, 2:3, 3:4}" as="foo">
      <f:cycle values="{0: 'odd', 1: 'even'}" as="zebraClass">
         <li class="{zebraClass}">{foo}</li>
      </f:cycle>
   </f:for>
   </ul>

Output::

   <ul>
      <li class="odd">1</li>
      <li class="even">2</li>
      <li class="odd">3</li>
      <li class="even">4</li>
   </ul>

Note: The above examples could also be achieved using the "iteration" argument of the ForViewHelper

Arguments
=========


.. _cycle_values:
values
------

:aspect:`DataType`
   mixed

:aspect:`Required`
   true
:aspect:`Description`
   The array or object implementing \ArrayAccess (for example \SplObjectStorage) to iterated over

.. _cycle_as:
as
--

:aspect:`DataType`
   mixed

:aspect:`Required`
   true
:aspect:`Description`
   The name of the iteration variable