The <netui:anchor> tag generates a link to another document or invokes an action method in the Controller file.
The <netui:anchor> tag generates a link to another document or invokes an action method in the Controller file.
The <netui:anchor> tag also supports JavaScript-based form submission and URL re-writing.
An anchor must have one of five attributes to correctly create the hyperlink:
accessKey | The keyboard navigation key for the element.
The following values are not recommended because they
are often used by browsers: A, C, E, F, G,
H, V, left arrow, and right arrow |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
action | The action method to invoke. The action method must be in the Controller file
of the Page Flow directory. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
formSubmit | Boolean. If formSubmit is set to true, and the <netui:anchor> tag
is within a <netui:form> tag,
then the form data will be submitted to the method named in the
<netui:form> tag's action attribute. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
forward | The logical forward name from which to retrieve the hyperlink URI. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
href | The URL to go to. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
id | The id attribute is deprecated, use the tagId attribute instead.
The id attribute of the rendered HTML tag. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
linkName | An internal place on the page to go to. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
location | Location within the URI to visit. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
onBlur | The onBlur JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onClick | The onClick JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onDblClick | The onDblClick JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onFocus | The onFocus JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onKeyDown | The onKeyDown JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onKeyPress | The onKeyPress JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onKeyUp | The onKeyUp JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onMouseDown | The onMouseDown JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onMouseMove | The onMouseMove JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onMouseOut | The onMouseOut JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onMouseOver | The onMouseOver JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
onMouseUp | The onMouseUp JavaScript event. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
page | The page attribute is deprecated. The module-relative page URL to which this hyperlink will
be rendered. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
style | The style of the rendered HTML tag. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
styleClass | The class of the rendered HTML tag. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
tabindex | The tabIndex of the rendered HTML tag. This attribute determines the position of the
rendered HTML tag in the sequence of tags that the user may advance through by pressing the TAB key. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
tagId | String value. Sets the id (or name ) attribute of the rendered HTML tag.
Note that the real id attribute rendered in the browser may be
changed by the application container (for example, Portal containers may change
the rendered id value to ensure the uniqueness of
id's on the page). In this case, the real id rendered
in the browser may be looked up
through the JavaScript function getNetuiTagName( tagId, tag ).
For example, assume that some tag's tagId attribute is set to foo .
<netui:textBox tagId="foo" />
Then the following JavaScript function will return the real id attribute rendered in the browser:
getNetuiTagName( "foo", this )
To get a <netui:form> element and all of its children elements in JavaScript, use
the same JavaScript function getNetuiTagName( tagId, tag ) . For example,
assume that there is a <netui:form> whose
tagId attribute is set to bar .
<netui:form tagId="bar" >
Then the following JavaScript function will return the <netui:form> element
and its children (packaged as an array).
document[getNetuiTagName( "bar", this )]
To retreive the value entered into a <netui:textBox> within the <netui:form> tag, use the following
JavaScript expression.
document[getNetuiTagName("bar", this)][getNetuiTagName("foo", this)].value
The second parameter ensures that the JavaScript function
begins its search within the correct Portlet scope. Pass the
JavaScript keyword this as the second parameter.
For detailed information on using the function
getNetuiTagName( tagId, tag ) see
Using JavaScript in Page Flow and Portal Applications. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | Yes | No |
|
|
target | The window target. |
|
Required | Supports runtime expression evaluation | Data bindable |
No | No | No |
|
|
In this sample, clicking on this anchor submits the form data and invokes the method
submitForm
.
The JavaScript function will be invoked by the generated HTML anchor tag as follows: