url
HTML link. Creates a link to a URL or a Action / event pair. If the tag has a body, renders a HTML link around it. Else, it will use the title attribute as a body. To render just a link, use l:link instead
| Tag Information | |
|---|---|
| Tag Class | org.loom.tags.core.UrlTag | 
| Body Content | scriptless | 
| Dynamic Attributes | true | 
| Example | <l:url action="BlogEntries" event="open" param-foo="${foo}"/>
<l:url mapping="BlogEntries.open" />
<l:url href="/foo/bar">Click here</l:url> | 
                                    
Attributes
| Name | Description | Flags | 
|---|---|---|
| accesskey | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| action | The action this link points to. Either this or href must be specified | 
                                             rtexprvalue 
                                         | 
                                    
| charset | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| class | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| decorator | The name of the decorator to use. The default decorators for any form field will display the surrounding label. | 
                                             rtexprvalue 
                                         | 
                                    
| dir | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| encodeParameters | true to encode the query string. defaults to true (LOOM-188) | 
                                             rtexprvalue 
                                         | 
                                    
| event | The event this link points to. If action is specified but event is not, the default event will be assumed. If the action does not define a default event, an exception will be thrown. Either action/event or href must be set. | 
                                             rtexprvalue 
                                         | 
                                    
| hash | The hash of the url (the fragment after '#') | 
                                             rtexprvalue 
                                         | 
                                    
| hostname | The server name to use. If not specified, the current request.getServerName() value will be used. | 
                                             rtexprvalue 
                                         | 
                                    
| href | HTML attribute The target url. Either this or the action / event pair must be set. | 
                                             rtexprvalue 
                                         | 
                                    
| hreflang | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| id | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| if | Set to false to skip tag execution. | 
                                             rtexprvalue 
                                         | 
                                    
| lang | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| mapping | The mapping as action.event. This method is equivalent to 
                                            setting action and event separately.
                                         | 
                                        
                                             rtexprvalue 
                                         | 
                                    
| name | HTML attribute with different meanings: | 
                                             rtexprvalue 
                                         | 
                                    
| port | The port to use. If not specified, the current request port will be used. | 
                                             rtexprvalue 
                                         | 
                                    
| rel | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| relative | true if the url is relative (do not render schema, server or port), false to render a full URL. Default is true | 
                                             rtexprvalue 
                                         | 
                                    
| rev | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| scheme | The scheme to use. If not specified, the current request scheme will be used. | 
                                             rtexprvalue 
                                         | 
                                    
| scope | If var is not null, this is the scope where the value will be stored.
                                            Possible values are page (default), request,
                                            session and application.
                                         | 
                                        
                                             rtexprvalue 
                                         | 
                                    
| shape | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| style | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| tabindex | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| target | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| title | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| translateTitle | set to true to translate title, default true | 
                                             rtexprvalue 
                                         | 
                                    
| type | HTML attribute | 
                                             rtexprvalue 
                                         | 
                                    
| var | If specified, store the url value instead of rendering it | 
                                             rtexprvalue 
                                         |