The RowRepeater control is used to repeat complex controls. It is best used in cases where a tabular layout is not possible, for example when viewing an RSS feed, or displaying complex search results. The data to be displayed is bound to the RowRepeater using the data binding feature the framework provides. By using the bindRows(bindingPath,rowControl)
method, one can specify the binding path pointing to the model data, as well as the control that shall display this data and is repeated for each row.
The RowRepeater offers filtering and sorting features. It is possible to define multiple filters and sorters, they are available in the header and in the toolbar of the RowRepeater then. Filtering and sorting can also be triggered via the RowRepeater’s public API (see API documentation).
In order to be able to browse through the RowRepeater, paging features are available. By default, the RowRepeater displays a Paginator. The number of rows to be displayed can be set at design-time, as well as the index of the page to load on first rendering via the attributes numberOfRows
and currentPage
. It is possible to switch to the ShowMore
mode of paging by setting the showMoreSteps
attribute. Once this attribute is set, the RowRepeater hides the Paginator and displays a button that makes the control grow to show more rows each time it is clicked. Using this attribute also allows to determine how many rows need to be added after each click. All functions are also available in the public API
The RowRepeater comes with three different visual designs: standard
, transparent
and bareshell
.
In its standard
design, the RowRepeater displays all of it features: The header with filter, the toolbar with sorters,
the footer with paginator or show more
button. The transparent
design reuses the standard
design and
makes all the borders and backgrounds transparent. The bareshell
design hides header, toolbar and
footer. Every functionality of the RowRepeater can be accessed via its public API.
See also: Paginator