(Quick Reference)

each

Purpose

Uses the Groovy JDK each method to iterate over each element of the specified object.

Examples

<g:each in="${books}">
     <p>Title: ${it.title}</p>
     <p>Author: ${it.author}</p>
</g:each>

With a named item:

<g:each var="book" in="${books}">
     <p>Title: ${book.title}</p>
     <p>Author: ${book.author}</p>
</g:each>

With a range literal - note how the literal must be enclosed in parentheses:

<ul>
  <g:each var="i" in="${ (0..<100) }">
    <li>Item ${i}</li>
  </g:each>
</ul>

Another example, where a named item is necessary (otherwise the access to the title property will fail):

<g:each in="${itemList}" var="item">
    <g:link action="show" id="${item.id}">${item.title}</g:link>
</g:each>

Using the status parameter to alternate the coloring of a table's rows:

<tbody>
  <g:each status="i" in="${itemList}" var="item">
    <!-- Alternate CSS classes for the rows. -->
    <tr class="${ (i % 2) == 0 ? 'a' : 'b'}">
      <td>${item.id?.encodeAsHTML()}</td>
      <td>${item.parentId?.encodeAsHTML()}</td>
      <td>${item.type?.encodeAsHTML()}</td>
      <td>${item.status?.encodeAsHTML()}</td>
    </tr>
  </g:each>
</tbody>

Description

Attributes

  1. in - The object to iterate over
  2. status (optional) - The name of a variable to store the iteration index in. For the first iteration this variable has a value of 0, for the next, 1, and so on. If this parameter is used, then var is required.
  3. var (optional) - The name of the item, defaults to "it".

Note that var attribute must be specified when the iterator value is to be used from within the body of a GSP Dynamic Tag, such as in <g:link>.