Tag that generates HTML links, used for linking to pages and ActionBean events
within a Stripes application. Works in concert with zero or more nested param tags
in order to allow addition of arbitrary parameters to any URL. The body of the tag,
minus any param tags, is trimmed for whitespace at either end, and is then used
as the contents of the link body.
There are two attributes which are not a mirrors of attributes on the HTML anchor
tag. The first is the 'event' attribute. This allows specification of a specific event
to trigger when linking to an ActionBean URL. The second is 'beanclass' which allows
the specification of the class name or Class instance for an ActionBean as an
alternative to specifying the 'href' attribute.
Attributes |
Name | Required | Request-time | Type | Description |
event | false | true | java.lang.String |
The (optional) event that should be fired if the link is to an ActionBean. If not
supplied then the tag will not render an explicit event (but one may by built in
to the URL/href supplied).
|
addSourcePage | false | true | java.lang.String |
Indicates if the _sourcePage parameter should be appended to the URL. Default
value is false.
|
prependContext | false | true | java.lang.Boolean |
Indicates if the application context path should be included at the beginning of
the generated URL.
|
beanclass | false | true | java.lang.Object |
The fully qualified name of an ActionBean class, or alternatively a Class instance
for an ActionBean class. An alternative to the 'href' attribute, the 'beanclass'
attribute will generate an href appropriate for the ActionBean identified. Note
that if an ActionBean that does not yet exist is identified an exception will
be thrown!
|
anchor | false | true | java.lang.String |
The (optional) anchor that is appended at the end of the generated URL.
If the URL specified by the value attribute already contains the anchor then
the anchor specified by this attribute takes precedence.
|
charset | false | true | java.lang.String | The character set used to encode the referenced page. (HTML Pass-through) |
coords | false | true | java.lang.String | Used to define a region for clicking in an image map. (HTML Pass-through) |
href | false | true | java.lang.String |
The target URL. If the URL starts with a slash and does not contain the current
web application context path, then the context path will be prepended to the URL.
(HTML Pass-through)
|
hreflang | false | true | java.lang.String | The language of the target page. (HTML Pass-through) |
name | false | true | java.lang.String | The name of an anchor. (HTML Pass-through) |
rel | false | true | java.lang.String |
Specified the relationship between the current page and the target URL.
(HTML Pass-through)
|
rev | false | true | java.lang.String | Like rel, but in reverse. |
shape | false | true | java.lang.String | Used to define a shape within an image map. |
target | false | true | java.lang.String | The frame or window in which the link will open. |
type | false | true | java.lang.String | The MIME type of the target URL. |
accesskey | false | true | java.lang.String | Keyboard shortcut to access the element. (HTML Pass-through) |
class | false | true | java.lang.String | The CSS class to be applied to the element. (HTML Pass-through) |
dir | false | true | java.lang.String | Text direction. (HTML Pass-through) |
id | false | true | java.lang.String | A unique identifier for the HTML tag on the page. (HTML Pass-through) |
lang | false | true | java.lang.String | The language code of the element. (HTML Pass-through) |
onblur | false | true | java.lang.String | Scripting code run when the element loses focus. (HTML Pass-through) |
onchange | false | true | java.lang.String | Scripting code run when the element changes. (HTML Pass-through) |
onclick | false | true | java.lang.String | Scripting code run on each mouse click. (HTML Pass-through) |
ondblclick | false | true | java.lang.String | Scripting code run on a double-click of the mouse. (HTML Pass-through) |
onfocus | false | true | java.lang.String | Scripting code run when the element acquires focus. (HTML Pass-through) |
onkeydown | false | true | java.lang.String | Scripting code run when a key is depressed. (HTML Pass-through) |
onkeypress | false | true | java.lang.String | Scripting code run when a key is pressed and released. (HTML Pass-through) |
onkeyup | false | true | java.lang.String | Scripting code run when a key is released. (HTML Pass-through) |
onmousedown | false | true | java.lang.String | Scripting code run when a mouse button is depressed. (HTML Pass-through) |
onmousemove | false | true | java.lang.String | Scripting code run when the mouse pointer is moved. (HTML Pass-through) |
onmouseout | false | true | java.lang.String | Scripting code run when the mouse pointer moves out of the element. (HTML Pass-through) |
onmouseover | false | true | java.lang.String | Scripting code run when the mouse pointer moves over the element. (HTML Pass-through) |
onmouseup | false | true | java.lang.String | Scripting code run when a mouse button is released. (HTML Pass-through) |
onselect | false | true | java.lang.String | Scripting code run when an element is selected. (HTML Pass-through) |
style | false | true | java.lang.String | Inline CSS style fragment that applies to the element (HTML Pass-through) |
tabindex | false | true | java.lang.String | The tab order of the element. (HTML Pass-through) |
title | false | true | java.lang.String | Tool-tip text for the element. (HTML Pass-through) |