A low level
Table
component that generates the rows of the current page in the table. This component
must be wrapped by
TableView
.
The component iterates over the rows of the current page in the table. The rows are
wrapped in 'tr' tags by default. You can define columns manually within, or you can
use
TableValues
to generate the columns automatically.
See also: Table , TableView , TablePages , TableRows , TableValues , TableColumns
Name | Type | Required | Default | Description |
---|---|---|---|---|
row | Object | no | The value object of the current row being rendered. | |
index | Object | no | If provided, the parameter is updated with the index of the loop on each iteration. | |
element | String | no | tr | The tag to use to wrap the rows in. |
keyExpression | Object | no | Only active in a form. An OGNL expression that returns the primary key of the iterated value. The primary keys are stored in hidden fields during rendering and are loaded from the form during a rewind to ensure that the iterations remain the same. This is a simpler, but a less efficient alternative of the 'converter' parameter. If needed, please use in conjuction with 'fullSource' to reference objects not currently present in 'source'. Also, use the 'defaultValue' parameter to define the object to be returned if a value corresponding to a particular primary key cannot be found. | |
fullSource | Object/Collection | no | Only active in a form and in combination with the 'keyExpression' parameter. If an object corresponding to a primary key stored in the form cannot be found in the 'source' parameter, then the objects provided by this parameter are searched for a match next. | |
defaultValue | Object | no | null | Only active in a form. The value to be used when no match for a given primary key is found. |
converter | Object | no | null | Only active in a form. Defines how the items iterated upon will be stored in the form as hidden values and how the stored information will be converted back to objects. This interface allows only the primary key of the items to be stored, rather than the whole item. |
primaryKeys | Object | no | Only active in a form. If provided, the parameter is automatically updated before a rewind with the list of primary keys stored in the form. The parameter is updated right before the iterations begin in a rewind and could be used to preload the relevant objects in a provided 'converter'. | |
volatile | boolean | no | false | Only active in a form. Determines whether to avoid creating hidden fields within a form. Using this parameter may make the form structure different during render and rewind, and cause exceptions as a result. Please use with caution. |
Body: removed
Informal parameters: allowed
Reserved parameters: none