Taglib documentation for tag mak:resultList#
Description#
Similar to, and based on the <mak:list>, this tag automatically iterates over the results from a specified search form. The label of the result objects is automatically assumed to be "o". On top of <mak:list>, the following attributes are available:
.
Attributes#
| Name | Required | Runtime expression | Description | Comments |
|---|---|---|---|---|
| resultsFrom | true | false | The name of the search form the results are taken from.
. |
.
|
| mode | false | true | The default behaviour of the resultList when the search was not yet done.
. |
Accepted values are 'search' for displaying no results, and 'filter' for displaying all results; defaults to 'search'.
.
|
| staticWhere | false | false | A static where condition that is always added to the one generated by the search form.
. |
.
|
| orderBy (from mak:list) |
false | false | MQL ORDER BY section
. |
Can contain #{ JSP EL expressions } label.$fieldname used to be supported, not anymore
.
|
| groupBy (from mak:list) |
false | false | MQL GROUP BY section
. |
Can contain #{ JSP EL expressions }
.
|
| offset (from mak:list) |
false | false | the offset of the result to show (0 for starting from the first result)
. |
$attribute allowed. If $attribute is not found, defaults to 0. Only allowed for the outermost mak:list
.
|
| limit (from mak:list) |
false | false | the maximum numbers of results to show (-1 for all results)
. |
$attribute allowed. Only allowed for the outermost mak:list. if $attribute is not found, defaults to the value of defaultLimit, if present, or -1 otherwise. LIMIT can limit the query time dramatically, but the children mak:lists are not yet limited.
.
|
| defaultLimit (from mak:list) |
false | false | the default value for limit, if the $attribute in limit="$attribute" is not present.
. |
$attribute allowed. Only allowed for the outermost mak:list.
.
|
| id (from mak:list) |
false | false | Tag's identifier
. |
Can be used to distinguish otherwise identical tags on a page (to avoid confusion by Makumba's JSP analyser)
.
|
| db (from mak:list) |
false | true | The makumba database to connect to. The format is Host_SQLEngineType_DatabaseName If not present, the default database is used. See database configuration and lookup.
. |
Cannot contain attributes, for now. The default database is chosen if this argument is not set. Can only be set for top-level (root) query tags Can be a Rtexpr <%= ...%>
.
|
| separator (deprecated) (from mak:list) |
false | true | Character string as separator between two list elements. It is not included before the first or after the last
. |
Deprecated, use <c:if test="${mak:count<mak:maxCount()}"> instead.
.
|
See also#
mak:searchForm, mak:criterion, mak:matchMode, mak:searchField
Examples#
Note that the label of result objects is assumed to be "o" by default!
.
<mak:resultList resultsFrom="searchEmployee">
Name: <mak:value expr="o.name"/> <mak:value expr="o.surname"/><br/>
</mak:resultList>