ICE Components
Tag menuItem


MenuItem components are the menu items contained by a menuBar. The value attribute defines the label displayed for the menuItem. The icon attribute can be used to specify an image that displays on the left side of the menuItem. The action and actionListener attributes operate in the same way os the standard component attributes of the same name. The menuItem component is only used in the static approach to defining the heirarchy of menu items.


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

Attributes
NameRequiredRequest-timeTypeDescription
actionfalsefalsejava.lang.StringMethodBinding representing the application action to invoke when this component is activated by the user. The expression must evaluate to a either a String or a public method that takes no parameters, and returns a String (the logical outcome) which is passed to the NavigationHandler for this application.
actionListenerfalsefalsejava.lang.StringMethodBinding representing an action listener method that will be notified when this component is activated by the user. The expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void.
altfalsefalsejava.lang.StringPassed through to IMG tag of rendered icon in MenuItem
bindingfalsefalsejava.lang.StringThe value binding expression linking this component to a property in a backing bean
disabledfalsefalsejava.lang.StringIndicates tab should be disabled.
enabledOnUserRolefalsefalsejava.lang.StringIf user is in given role, this component will be rendered normally. If not, the component will be in disabled state.
iconfalsefalsejava.lang.Stringicon
idfalsefalsejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
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.
linkfalsefalsejava.lang.Stringlink
onclickfalsefalsejava.lang.StringJavascript to be executed before the MenuItem's CommandLink submits to the server.
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.
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.

As the top level menu items are part of the menuBar so the style class names rendered differently for top level and non to level menu items.

The base name rendered same for all non top level menu item regardless of orientation. Default value is iceMnuItm

if enabled
  • iceMnuItm
  • iceMnuItmImage
  • iceMnuItmLabel
if disabled
  • iceMnuItm-dis
  • iceMnuItmImage-dis
  • iceMnuItmLabel-dis

As the top level menu item is part of the MenuBar, so it is possible to have different representation for horizontal and vertical menu.
For the top level menu items the style class base name depends on orientation of the menu . Default value for top level menu item iceMnuBar:
if enabled + horizontal

  • iceMnuBarItem
  • iceMnuBarItemImage
  • iceMnuBarItemLabel
if enabled + vertical
  • iceMnuBarVrtItem
  • iceMnuBarVrtItemImage
  • iceMnuBarVrtItemLabel
if disabled + horizontal
  • iceMnuBarItem-dis
  • iceMnuBarItemImage-dis
  • iceMnuBarItemLabel-dis
if disabled + vertical
  • iceMnuBarVrtItem-dis
  • iceMnuBarVrtItemImage-dis
  • iceMnuBarVrtItemLabel-dis

targetfalsefalsejava.lang.Stringtarget
titlefalsefalsejava.lang.StringPassed through to root DIV tag of rendered MenuItem
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.