ICE Components
Tag menuBar


The menuBar component provides a robust menu system that supports:

  1. Nested child menuItem and menuItemSeparator components. Support for menuItemCheckbox and menuItemRadio components are planned for a future release.
  2. Horizontal (default) and Vertical menu orientations. Defines whether the submenus of the top-level menu items appear beside or below the top-level menu items.
  3. Definition of the heirarchy of menu items and their submenus in one of two ways:
  4. The action attribute of the contained menuItem tags or instances can be defined to indicate a string or a backing bean method that can be used in application navigation.
  5. The actionListener attribute of the contained menuItem tags or instances can be defined to indicate an actionListener that resides in a backing bean.

See the menuItem component's description for more relevant information.



Tag Information
Tag Classcom.icesoft.faces.component.menubar.MenuBarTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
bindingfalsefalsejava.lang.StringThe value binding expression linking this component to a property in a backing bean
displayOnClickfalsefalsejava.lang.String

By default the sub menus are being displayed on the hover event. which can be replaced with the click event by setting this attribute to true.

idfalsefalsejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
imageDirfalsefalsejava.lang.StringSet directory for location of the tree images. Default directory is /xmlhttp/css/xp/css-images/ which is include in the icefaces.jar.
immediatefalsefalsejava.lang.StringFlag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase.
keyboardNavigationEnabledfalsefalsejava.lang.StringEnables keyboard support, default value is true.
noIconsfalsefalsejava.lang.StringIf true, this component will not rendered icons and icon spacers in menuItems. The default is false. By default icons are rendered.
orientationfalsefalsejava.lang.StringDefines the orientation of the top-level menu items, whether they are layed out in a horizontal or vertical fashion. When horizontal, sub menus appear below, and when vertical they appear to the side. The default is horizontal.
renderedfalsefalsejava.lang.StringFlag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit.
renderedOnUserRolefalsefalsejava.lang.StringIf user is in given role, this component will be rendered normally. If not, nothing is rendered and the body of this tag will be skipped.
scrollableDivModefalsefalsejava.lang.String

By default (false) the sub menus positions are adjusted properly when in scrollable browser window. When set to true, sub menus positions are adjusetd in scrollable divs but not in scrollable browser window.

stylefalsefalsejava.lang.StringCSS style(s) to be applied when this component is rendered.
styleClassfalsefalsejava.lang.StringSpace-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup.
The base name for all style classes. Default value is iceMnuBar

if enabled + horizontal
  • iceMnuBar
  • iceMnuBarItem
  • iceMnuBarItemLabel
  • iceMnuBarItemImage
  • iceMnuBarSubMenu
  • iceMnuBarSubMenuInd
if enabled + vertical
  • iceMnuBarVrt
  • iceMnuBarVrtItem
  • iceMnuBarVrtItemLabel
  • iceMnuBarVrtItemImage
  • iceMnuBarVrtSubMenu
  • iceMnuBarVrtSubMenuInd
if disabled + horizontal
  • iceMnuBar-dis
  • iceMnuBarItem-dis
  • iceMnuBarItemLabel-dis
  • iceMnuBarItemImage-dis
  • iceMnuBarSubMenu-dis
  • iceMnuBarSubMenuInd-dis
if disabled + vertical
  • iceMnuBarVrt-dis
  • iceMnuBarVrtItem-dis
  • iceMnuBarVrtItemLabel-dis
  • iceMnuBarVrtItemImage-dis
  • iceMnuBarVrtSubMenu-dis
  • iceMnuBarVrtSubMenuInd-dis
valuefalsefalsejava.lang.StringThe current value of this component.

Variables
No Variables Defined.


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.