Show TOC

navNodeAnchorLocate this document in the navigation structure

Use

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:

  • 0: Added to history with duplicates

  • 1: Added to history without duplicates (default)

  • 2: No tracking

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:

  • true (default)

  • false

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:

  • byEPCM: Use client-side eventing (a Javascript call defined in the anchor's onclick attribute).

  • byEPCMwithURL: Use client-side eventing as above, but also set the anchor's href attribute to the navigation URL.

    The actual navigation is performed by the EPCM method, so the href URL is ignored. This URL is used when the user right-clicks the link and chooses Open in New Window or Add to Favorites from the browser's context menu.

  • byURL: Do not use client-side eventing. This eliminates the need for EPCM Javascript, reducing network traffic. This option is useful, for example, for the implementation of an external-facing portal in low-bandwidth scenarios.

    This option prevents the navigation node from being added to the history list.

    For more information, see Implementing an External-Facing Portal .

navigationMode

No

Indicates how to launch the node when the user clicks the link.

The following are valid values:

  • 0: Node is launched in the same frame.

  • 1: Node is launched in new window.

  • 2: Node is launched in a new session of the portal, which is displayed in a new window.

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

Example

The following creates a navigation link using a quick link or a quick link path if it is available for the node.

Sample Code
<nav:ifNavNodeInSelectedPath>
    <em><nav:navNodeAnchor 
         navigationMethod="byURL" 
         useQuickLink="true"/></em>
</nav:ifNavNodeInSelectedPath>