# 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>`.