Show TOC

iterateNavNodesInSelectedPathLocate this document in the navigation structure

Use

Iterates through the nodes in the path selected by the user.

For example, if the user selects Start of the navigation path Content Administration Next navigation step Users Next navigation step  Create User End of the navigation path, the tag iterates through these three nodes.

During each iteration of the tag, a different node is exposed in the body of the tag, either via a cooperating tag that accesses the current node in the iteration or the scriptlet variable defined by the currentNavNode attribute.

For more information about the selected path, see Key Terms and Concepts .

Attributes

Name

Mandatory

Description

currentLevel

No

The name of the Java variable to create for holding a Byte object for the current level of navigation on which the iteration is performed. The variable can be accessed in scriptlets in the body of the tag.

currentNavNode

No

The name of the Java variable to create for holding the INavigationNode object for the current node in the iteration.

The variable can be accessed in scriptlets in the body of the tag.

direction

No

Indicates in which direction to iterate. The attribute can have the following values:

  • forward (default) : Iterate from the first to the last node

  • backward: Iterate from the last to the first node

Variables

Name

Scope

Description

currentLevel> attribute

Body of tag

A Byte object representing the current level of navigation on which the iteration is performed.

< currentNavNode> attribute

Body of tag

INavigationNode object representing the current node in the iteration.

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 breadcrumb list of links to the nodes in the selected path. The last node, which is the launched or context node, is rendered as text only. The breadcrumb entries are separated by the > sign

<nav:iterateNavNodesInSelectedPath>
    <nav:ifHasMoreIterations>
        <nav:navNodeAnchor navigationMethod="byURL"/> >
    </nav:ifHasMoreIterations>
    <nav:ifNotHasMoreIterations>
        <nav:navNodeTitle/>
    </nav:ifNotHasMoreIterations>
</nav:iterateNavNodesInSelectedPath>
More Information