link

Purpose

Creates an html anchor tag with the href set based on the parameters specified.

Examples

Example controller for an application called "shop":

class BookController {
     def list = { [ books: Book.list( params ) ] }
     def show = { [ book : Book.get( params['id'] ) ] }
}

Example usages for above controller:

<g:link action="show" id="1">Book 1</g:link>
<g:link action="show" id="${currentBook.id}">${currentBook.name}</g:link>
<g:link controller="book">Book Home</g:link>
<g:link controller="book" action="list">Book List</g:link>
<g:link url="[action:'list',controller:'book']">Book List</g:link>
<g:link action="list" params="[sort:'title',order:'asc',author:currentBook.author]">
     Book List
</g:link>

Example as a method call in GSP only:

<%= link(action:'list',controller:'book') { 'Book List' }%>

Results in:

<a href="/shop/book/list">Book List</a>

Description

Attributes

• action (optional) - the name of the action to use in the link, if not specified the default action will be linked
• controller (optional) - the name of the controller to use in the link, if not specified the current controller will be linked
• id (optional) - the id to use in the link
• params (optional) - a map containing request parameters
• url (optional) - a map containing the action, controller, id etc.

Source

Show Source

def link = { attrs, body ->  
		def writer = out
        writer << '<a href="'
        // create the link 
		if(request['flowExecutionKey']) {
			if(!attrs.params) attrs.params = [:]
			attrs.params."_flowExecutionKey" = request['flowExecutionKey']
		}
        writer << createLink(attrs).encodeAsHTML()
        writer << '"'
        // process remaining attributes
        attrs.each { k,v ->
            writer << " $k=\"$v\""
        }
        writer << '>'
        // output the body
        writer << body()
        // close tag
        writer << '</a>'
    }