
Outputs an HTML link (the <a> tag with a nested text or an image) for navigating to the current navigation node.
For more information about creating navigation links, see Triggering Navigation .
Attributes
|
Name |
Mandatory |
Description |
|---|---|---|
|
anchorAttributes |
No |
A string that is added inside the anchor tag, in which you can add additional HTML attributes for the anchor tag, such as class |
|
EPCMHistoryMode |
No |
Indicates whether the navigation node is added to the portal's history list on the page title bar and, if it is, whether duplicate entries are allowed if a user clicks on the link multiple times. The valid values are:
This attribute is only relevant when the navigationMethod attribute is set to byEPCM . |
|
hashURL |
No |
Indicates whether to set the value of the anchor's href attribute to the standard navigation URL or to its hashed URL. The following are valid values:
Any other value is regarded as true . |
|
locale |
No |
Indicates the locale to use for retrieving and displaying the node's title. Valid values are the string representations of java.util.Locale objects, such as en , en_US , de_DE , zh_CN . If not specified, the request locale is used. |
|
navigationContext |
No |
The navigation node to set as selected. With this attribute, you can launch one navigation node but set another navigation node to appear in navigation iViews as if it was selected. Specify a node by its name, which is the same as the value returned by INavigationNode.getName() , for example, ROLES://portal_content/myFolder/myRole/myIView . |
|
navigationMethod |
Yes |
Indicates whether to use client-side eventing for navigation after the user clicks the link. The valid values are:
|
|
navigationMode |
No |
Indicates how to launch the node when the user clicks the link. The following are valid values:
The values are defined by the constants defined in INavigationConstants and with the prefix SHOW . |
|
title |
No |
The visible text for the link. If not specified, the title of the navigation node is used, which is the same as the value returned by INavigationNode.getTitle() . |
|
urlParameters |
No |
A string that is appended to the URL in the anchor tag's href attribute. This attribute enables you to add parameters to the link URL. |
|
useQuickLink |
No |
Indicates whether to use a navigation URL with a quick link instead of a URL with a NavigationTarget parameter, if the navigationMethod attribute of this tag is set to URL and a quick link is assigned to the current node. If a quick link path is available for the current node that is deeper than the first level, the quick link path is preferred to a single quick link. The valid values are true and false (default). Any other value is regarded as true . |
|
id |
No |
The ID of the generated tag |
|
sendWindowID |
No |
Determines whether to pass the unique identifier of the current window in the request. Passing this identifier prevents the loss of navigation context when navigating to invisible objects or PCD objects, which are not included in a role structure. Boolean. The default value is true. |
Cooperating Tags
The tag must be nested in one of the following tags:
contextNavNode
iterateInitialNavNodes
iterateNavNodeChildren
iterateNavNodesInSelectedPath
iterateSelectedNavNodesLevel
launchedNavNode
navNode
navNodeParent
recallNavNode
recurseNavNodeChildren
selectedNavNode
The following creates a navigation link using a quick link or a quick link path if it is available for the node.
<nav:ifNavNodeInSelectedPath>
<em><nav:navNodeAnchor
navigationMethod="byURL"
useQuickLink="true"/></em>
</nav:ifNavNodeInSelectedPath>