:navigation-title: iterator.random
.. include:: /Includes.rst.txt

.. _fluidtypo3-vhs-iterator-random:

==================================================
iterator.random ViewHelper `<vhs:iterator.random>`
==================================================


Returns random element from array.


.. _fluidtypo3-vhs-iterator-random_arguments:

Arguments
=========


.. _iterator.random_subject:

subject
-------

:aspect:`DataType`
   mixed

:aspect:`Required`
   false
:aspect:`Description`
   The subject Traversable/Array instance from which to select a random element

.. _iterator.random_as:

as
--

:aspect:`DataType`
   string

:aspect:`Required`
   false
:aspect:`Description`
   Template variable name to assign; if not specified the ViewHelper returns the variable instead.