Link Search Menu Expand Document

repeatable

Please see Core Concepts - Repeatable Regions for an in-depth discussion about this tag.

Parameters

  • name
  • label
  • order
  • limit
  • offset
  • stacked_layout
  • startcount

name

A unique name identifying the repeatable block created by this tag. This parameter is mandatory.

label

Label instructs Couch to display a more user friendly name than the name attribute above. Unlike name, it has no limitation of the type of characters that can be used within it. If label attribute is not supplied, Couch by default uses the name as the label.

order

Can be set to either asc or desc or random for setting the sort order to ascending, descending or random.

<cms:show_repeatable 'banners' limit='1' order='random'>
  <cms:show banner />
</cms:show_repeatable>

limit

The 'limit' parameter will make the tag show only the specified number of rows.

<cms:show_repeatable 'contacts' order='desc' >..

offset

The 'offset' parameter will make the tag to begin showing the rows after skipping the number of rows specified in offset.

<cms:show_repeatable 'contacts' offset='2' >..

stacked_layout

Couch can display the regions stacked vertically (instead of horizontally in a row).

<cms:repeatable name='contacts' label='Contacts' stacked_layout='1'>

Variables

Two new variables are also made available while looping through the rows in repeatable-regions

<cms:show_repeatable 'contacts'>
    <cms:if k_first_row >
        ..
    </cms:if>

    ..

    <cms:if k_last_row >
        ..
    </cms:if>
</cms:show_repeatable>

To get the values entered into the editable regions enclosed by this block, use show_repeatable tag.