OpenCms JSP standard taglib
Tag navigation


This tag provides access to a list of elements that should be shown in the navigation, i.e., elements where at least one of the properties NavText or NavPos are set. The tag is the standard tool to build up dynamic page navigations.


Tag Information
Tag Classorg.opencms.jsp.CmsJspTagNavigation
TagExtraInfo ClassNone
Body Contentempty
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
vartruetruejava.lang.StringName of the exported variable that holds a suitably initialized org.opencms.jsp.util.CmsJspNavigationBean object. The object in particular provides a list of navigation elements (of type org.opencms.jsp.CmsJspNavElement), available via the property items.
typetruetruejava.lang.StringType of the navigation for which the entries should be collected. The type influences the collected navigation elements. Supported types are:
breadCrumb
Navigation elements for the folders from a specified startLevel (default: 0) up to and endLevel.

The endLevel can have values between the startLevel and the maximal endLevel, that is either the specified resource's level (if true is set as value for the param attribute), or the specified resource's level minus 1 (if false is set as value for the param attribute). The default endLevel is the maximal endLevel.
forFolder
Navigation elements for all (navigable) elements in the specified folder.
forResource
Navigation element for the specified resource (as singleton list).
forSite
Navigation elements for all (navigable) resources of the current site.

Optionally, an endLevel can be specified and an other top-folder than "/" can be specified via the attribute resource.

Note: If a folder has no navigation properties, the subfolders are not included, too.
treeForFolder
Navigation elements for (navigable) resources in the between startLevel and endLevel.

Not all resources are shown, the elements are collected according to the specified resource, i.e., only elements from "sublevels" on the path to this resource are collected.
startLevelfalsetruejava.lang.StringAbsolute start level for the navigation, used for different navigation types.

Default: Depends on the navigation type.
endLevelfalsetruejava.lang.StringAbsolute end level for the navigation, used for different navigation types.

Default: Depends on the navigation type.
resourcefalsetruejava.lang.StringA resource, typically a folder, relative to which the navigation should be build.

Default: The resource found under the request uri.
paramfalsetruejava.lang.StringAllows configuration for navigations of type "breadCrumb", see description of this navigation type.

localefalsetruejava.lang.StringThe locale, for which properties should be read. E.g., if you read the property "Title" for the locale "de_DE", then "Title_de_DE" will be read first, and only if it does not exist, "Title_de" and "Title" are tried as well.

Variables
NameTypeDeclareScopeDescription
From attribute 'var'org.opencms.jsp.util.CmsJspNavigationBeantrueAT_BEGINNo Description


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.