Download the PHP package rah/rah_repeat without Composer

</rah::repeat>

In addition to iterating over values and creating lists, the tag can also be used to extract values and assign each one to a "variable":https://docs.textpattern.com/tags/variable tag. This can be done using the @rah_repeat@ tag's @assign@ attribute. The attribute takes a comma-separated list of variable names that will be created, each containing one of the values.

bc.

The above would extra each of the colors as a variable. These variables would be named as @color1@, @color2@ and @color3@. Using @@ would return @red@.

h2. Tags and attributes

The plugin comes with a total of four tags. The main tag @rah::repeat@, a single tag @rah::repeat_value@, and two conditionals @rah::repeat_if_first@ and @rah::repeat_if_last@.

h3. rah::repeat

bc. ...contained statement... </rah::repeat>

The @@ tag is the plugin's main tag. It's a container tag used for iterations. Attributes for it are as follows.

value Sets the values that are passed to the tag. Multiple values are separated with the @delimiter@ which by default is a comma (@,@). If @range@ is set to @1@, individual values can declare dash-separated value ranges, e.g. @1-5, 8, 24-81, 9, 15@. Either this attribute or @range@ is required. Example: @value="dog, cat, human"@ Default: @""@

range Creates a list of values containing a range of elements, or if set to boolean @1@, enables the value ranges feature in the @value@ attribute. Using @range@ to create a list of values overrides @value@ attribute. It works identically to PHP's "range":https://secure.php.net/manual/en/function.range.php function and uses same sequence syntax as it. The attribute's value consists of three parts: @minimum@, @maximum@ and @step@, each separated by a comma. All but @step@ are required. If the @range@ is set to @1@, it enables similar feature in the @value@ attribute's individual delimiter-separated values. Example: @range="1, 10"@ Default: undefined

delimiter Sets the delimiter that is used to split the provided @value@ into a list. Default delimiter is comma (@,@). Example: @delimiter="|"@ Default: @","@

assign Assigns values as Textpattern's "variables":https://docs.textpattern.com/tags/variable. Takes a comma-separated list of variable names: @variable1, variable2, variable3, ...@. Example: @assign="label, value"@ Default: @unset@

duplicates Removes duplicate values from the list. If the attribute is set to @1@, only first occurrence of the value is used and duplicates are stripped off. Example: @duplicates="1"@ Default: @"0"@

exclude Exclude certain values from the list. The attribute takes a comma (or @delimiter@, if @delimiter@ is changed) separated list of values. Example: @exclude="foo,bar"@ Default: undefined

trim Trims values from extra whitespace. This can be particularly helpful if the provided values are from user-input (e.g. from an article field), or the values just have extra whitespace, and the resulting output has to be clean (i.e. used in XML, JavaScript or to a "variable":https://docs.textpattern.com/tags/variable comparison). If you want to keep whitespace intact, you can use this attribute. By default the option is on, and values are trimmed. Example: @trim="0"@ Default: @"1"@

sort Sorts the values. If the attribute is used, all values are rearranged to the specified order. Available options are @regular@ (sorts without checking the type), @numeric@ (sorts in a numeric order), @string@ (sorts as strings) and @locale_string@ (sorts according server's locale settings). All the values can be followed by the sorting direction, either @desc@ and @asc@. By default the option isn't used (unset), and the values are returned in the order they were supplied. Example: @sort="regular asc"@ Default: @""@

offset The number of items to skip. Default is @0@ (none). Example: @offset="5"@ Default: @"0"@

limit The number of items are displayed. By default there is no limit, and all items are returned. Example: @limit="10"@ Default: undefined

form Use specified form partial. By default contained statement is used instead of a form. Example: @form="price_column"@ Default: @""@

wraptag The (X)HTML tag (without brackets) used to wrap the output. Example: @wraptag="div"@ Default: @""@

break The (X)HTML tag (without brackets) or a string used to separate list items. Example: @"break="br"@ Default: @""@

class The (X)HTML class applied to the @wraptag@. Default is unset. Example: @class="plugin"@ Default: @""@

h3. rah::repeat_value

bc.