The Repeat Details page provides some control over how the contents of the repeat will be presented, including sorting and styling options. Many of these options work best if used on a repeat having one group as a child, which has a display method of Table. These details appear when a Repeat component is selected on the left hand panel representing the page elements.
The top of this page provides the full name of the current repeat, and a checkbox that can be used to try and solve display problems that may occur in some browsers.
Element Sorting
This section controls if and how the elements within this repeat will be sorted at runtime. Ticking the Sort Containing Elements checkbox indicates that the elements should be sorted and so requires some binding information to specify what to sort by.
The Sort Order option selects whether the data should be sorted in ascending or descending order, or alternatively can be set to dynamic to enable this option to be pulled in from the data used to construct the page at runtime. In a similar way, the Sort Data-type control can be set to text, number or dynamic. This option sets the type of data to sort and is needed, as for example, 10 would come before 2 if the sort data-type was text.
The Assume Default Sorting Behaviour checkbox will cause the system to make some assumptions about the sorting mechanism and the binding information required to try and minimise data entry requirements to achieve this functionality. This will add event handlers for the 'onclick' event to each label and will assume the required binding information.
If data is entered for the Sorted Heading Styling text boxes, this will override the styling specified on the field settings page for the label of the element that is currently being sorted. This provides a way for the page to show which element is currently being sorted.
Row and Column Styling
Both of these sections work in the same way, with one controlling row styling and the other column styling. The aim of these options is to create alternate styling of rows and columns in a table of data by switching between two different sets of styles.
The Alternate Styling select box turns this feature on or off, or sets it to dynamic, in which case some runtime data determines whether it should be applied or not.
The Change Interval specifies how often the styles should be changed. A value of 1 indicates that the styles will alternate after every row (or column) and so is likely to be the most common option. A value of 2 will create 2 rows (or columns) with the first style, then 2 with the second etc.
The styling text boxes allow the CSS class names or text strings for each of the two alternating styles to be specified. If any styling has been applied to the background of elements within this repeat, that will be applied as well as the alternating styles specified here.
The Restrict Table Height? option (under 'Advanced Options') can be used to restrict the number of entries within the repeat that are shown at any one time. This will cause vertical scrollbars to be displayed on the screen to allow the user to see all the entries. The Number of rows to display field should be used to specify how many to show.
This option is only available for repeats that contain a single group with a 'Display Method' of 'Table'