To have clean and re-usable Groovy Server Pages (GSP) we can use templates on our pages. A template contains HTML and code that we can maintain separately. In this post we learn about the template namespace to include a template on our page.
Suppose we have a page in our application that display a list of products. Each product has several properties we show. The template for a product is:
1 2 3 4 5 | <%-- File: grails-app/views/product/_productView.gsp --%><li class="${cssClassName}"> ${product.identifier} ${product.name} <g:formatNumber number="${product.price}" type="currency" currencyCode="EUR"/></li> |
We can use the template with the g:render tag and template attribute on our page:
1 2 3 4 5 6 7 8 9 10 11 12 13 | <%-- File: grails-app/views/product/list.gsp --%>...<ul> <g:render template="productView" var="product" collection="${products}" model="[cssClassName: 'info']"/></ul>...<ul> <g:each in="${products}" var="product"> <g:render template="productView" model="[product: product, cssClassName: 'info']"/> </g:each></ul>... |
But we can also use the template namespace feature in Grails. We define a tag with the namespace tmpl and the tagname is our template name. We pass the model for the template through the attributes. Each attribute name/value pair is passed as model to the template.
1 2 3 4 5 6 7 | <%-- File: grails-app/views/product/list.gsp --%>...<ul> <g:each in="${products}" var="product"> <tmpl:productView product="${product}" cssClassName="info"/> </g:each></ul>... |
