THIS IS A TEST INSTANCE. ALL YOUR CHANGES WILL BE LOST!!!!
Control Tags
Controls tags provide the ability to manipulate collections and conditionally produce content.
| Note |
|---|
Please make sure you have read the Tag Syntax document and understand how tag attribute syntax works. |
Iteration Tags
Iterator will iterate over a value. An iterable value can be either of: java.util.Collection, java.util.Iterator, java.util.Enumeration, java.util.Map, array.
Example:
| Code Block |
|---|
<ww:iterator value="days">
<p>day is: <ww:property/></p>
</ww:iterator>
|
The above example retrieves the value of the getDays() method of the current object on the value stack and uses it to iterate over. The <ww:property/> tag prints out the current value of the iterator.
The following example uses a BeanTag and places it into the ActionContext. The iterator tag will retrieve that object from the ActionContext and then calls its getDays() method as above. The status attribute is also used to create a IteratorStatus object, which in this example, its odd() method is used to alternate row colours:
| Code Block |
|---|
<ww:bean name="com.opensymphony.webwork.example.IteratorExample" id="it">
<ww:param name="day" value="'foo'"/>
<ww:param name="day" value="'bar'"/>
</ww:bean>
<table border="0" cellspacing="0" cellpadding="1">
<tr>
<th>Days of the week</th>
</tr>
<ww:iterator value="#it.days" status="rowstatus">
<tr>
<ww:if test="#rowstatus.odd == true">
<td style="background: grey"><ww:property/></td>
</ww:if>
<ww:else>
<td><ww:property/></td>
</ww:else>
</tr>
</ww:iterator>
</table>
|
The next example will further demonstrate the use of the status attribute, using a DAO obtained from the action class through OGNL, iterating over groups and their users (in a security context). The last() method indicates if the current object is the last available in the iteration, and if not, we need to seperate the users using a comma:
| Code Block |
|---|
<webwork:iterator value="groupDao.groups" status="groupStatus">
<tr class="<webwork:if test="#groupStatus.odd == true ">odd</webwork:if><webwork:else>even</webwork:else>">
<td><webwork:property value="name" /></td>
<td><webwork:property value="description" /></td>
<td>
<webwork:iterator value="users" status="userStatus">
<webwork:property value="fullName" /><webwork:if test="!#userStatus.last">,</webwork:if>
</webwork:iterator>
</td>
</tr>
</webwork:iterator>
|
The next example iterates over a an action collection and passes every iterator value to another action.
| Code Block |
|---|
<ww:action name="entries" id="entries"/>
<ww:iterator value="#entries.entries" >
<ww:property value="name" />
<ww:property />
<ww:push value="..."/>
<ww:action name="edit" id="edit" >
<ww:param name="entry" value="[0]" />
</ww:action>
</ww:iterator>
|
...
@see src/META-INF/taglib.tld
Next: Data Tags
...