(Quick Reference)

createLinkTo

Warning Deprecated: Use resource instead.

Purpose

Creates a link that can be used where necessary (for example in an href, JavaScript, Ajax call etc.)

Examples

Example controller for an application called "shop":

Example usages for the "shop" app:

<!-- generates "/shop/css/main.css" -->
<g:createLinkTo dir="css" file="main.css" />

<!-- generates "https://portal.mygreatsite.com/css/main.css" -->
<g:createLinkTo dir="css" file="main.css" absolute="true"/>

<!-- generates "https://admin.mygreatsite.com/css/main.css" -->
<g:createLinkTo dir="css" file="main.css" base="https://admin.mygreatsite.com"/>

Example as a method call in GSP only:

<link type="text/css" href="${createLinkTo(dir:'css',file:'main.css')}" />

Results in:

<link type="text/css" href="/shop/css/main.css" />

Description

Attributes

  • dir (optional) - the name of the directory containing the resource

  • file (optional) - the name of the resource file

  • absolute (optional) - If true will prefix the link target address with the value of the grails.serverURL property from the application configuration, or http://localhost:<port>; if there is no setting in the config and not running in production.

  • base (optional) - Sets the prefix to be added to the link target address, typically an absolute server URL. This overrides the behaviour of the absolute property if both are specified.