The Navigation Pane component is used to create the navigation items for one level in a page hierarchy. A page hierarchy is a tree-like hierarchy of nodes that represent a series of related pages in an application. End users gain access to information on the pages by drilling down a path of links.
The navigation items could be tabs, bars, or buttons, for example. The Navigation Pane component accepts a series of Command Navigation Item components as children, with each Command Navigation Item representing one item.
<af:navigationPane hint="buttons"> <af:commandNavigationItem text="Link 1"../> <af:commandNavigationItem text="Link 2"../> <af:commandNavigationItem text="Link 3"../> </af:navigationPane>
The type of navigation items is determined by the Hint attribute on the Navigation Pane component. The acceptable values of Hint include:
Each type is used to represent one level of nodes or pages in a page hierarchy. Typically, when you use Navigation Pane for navigation within a page hierarchy, you would use
tabs for first level nodes, and
bar for second level nodes. For pages that can be accessed from any page in the hierarchy (for example, a Help page), you would use
buttons to represent global links. In the example, you are merely using Navigation Pane to create a series of text links.
The Navigation Pane component can be declaratively bound to an XML menu model. Then instead of using individual Command Navigation Item components to represent the navigation links, you would use the
nodeStamp facet and only one Command Navigation Item to stamp out the appropriate number of links for that level.
Copyright © 1997, 2009, Oracle. All rights reserved.