Range ViewHelper `<f:range>`

Note

This reference is part of the documentation of Fluid Standalone. If you are working with Fluid in TYPO3 CMS, please refer to TYPO3's ViewHelper reference instead.

The RangeViewHelper returns an array containing a range of integers.

This ViewHelper mimicks PHP's range() function.

The following examples store the result in a variable because an array cannot be outputted directly in a template.

Examples

Increasing range

<f:variable name="result"><f:range start="1" end="5" /></f:variable>

{0: 1, 1: 2, 2: 3, 3: 4, 4: 5}

Inline increasing range

<f:variable name="result" value="{f:range(start: 1, end: 5)}" />

{0: 1, 1: 2, 2: 3, 3: 4, 4: 5}

Decreasing range

<f:variable name="result" value="{f:range(start: 5, end: 0)}" />

{0: 5, 1: 4, 2: 3, 3: 2, 4: 1, 5: 0}

Increasing stepped range

<f:variable name="result" value="{f:range(start: 1, end: 6, step: 2)" />

{0: 1, 1: 3, 2: 5}

Decreasing stepped range

<f:variable name="result" value="{f:range(start: 5, end: 1, step: 2)" />

{0: 5, 1: 3, 2: 1}

Go to the source code of this ViewHelper: RangeViewHelper.php (GitHub).

Arguments

The following arguments are available for the range ViewHelper:

end

Type: integer
Required: 1

Last possible value of the sequence.

start

Type: integer
Required: 1

First value of the sequence.

step

Type: integer
Default: 1

indicates by how much the produced sequence is progressed between values of the sequence.

Range ViewHelper <f:range>