Provides a paged list similar to the grid component. However, this uses a ul instead of a table by default. The list and its items are configurable via parameters.
| Name | Type | Flags | Default | Default Prefix | Description |
|---|---|---|---|---|---|
| clientId | String | NOT Allow Null | prop:componentResources.id | literal | |
| element | String | NOT Allow Null | prop:componentResources.elementName | literal | The element to render. If not null, then the loop will render the indicated element around its body (on each pass through the loop). The default is derived from the component template. |
| empty | org.apache.tapestry5.Block | NOT Allow Null | block:empty | prop | A Block to render instead of the table (and pager, etc.) when the source is empty. The default is simply the text "There is no data to display". This parameter is used to customize that message, possibly including components to allow the user to create new objects. |
| encoder | org.apache.tapestry5.PrimaryKeyEncoder | NOT Allow Null | prop | Optional primary key converter; if provided and inside a form and not volatile, then each iterated value is converted and stored into the form. | |
| index | int | NOT Allow Null | prop | The index into the source items. | |
| pagerPosition | String | NOT Allow Null | bottom | literal | Defines where the pager (used to navigate within the "pages" of results) should be displayed: "top", "bottom", "both" or "none". |
| rowsPerPage | int | NOT Allow Null | 25 | prop | The number of rows of data displayed on each page. If there are more rows than will fit, the Grid will divide up the rows into "pages" and (normally) provide a pager to allow the user to navigate within the overall result set. |
| source | Iterable | Required, NOT Allow Null | prop | Defines the collection of values for the loop to iterate over. | |
| value | Object | NOT Allow Null | prop | The current value, set before the component renders its body. | |
| volatile | boolean | NOT Allow Null | prop | If true and the Loop is enclosed by a Form, then the normal state saving logic is turned off. Defaults to false, enabling state saving logic within Forms. |