ICE Components
Tag menuPopup


A context sensitive popup menu providing popup nested child menus

By default the menuPopup doesn't cause any submit when displayed by the right click, that is why its contents can be static only but it could be dynamic by just registering the displayListener on it. The displayEvent gives the target component as well as the clientId of the target component in form of contextValue, which then can be use to produce dynamic contents.



Tag Information
Tag Classcom.icesoft.faces.component.menupopup.MenuPopupTag
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
blockMenuOnInputfalsefalsejava.lang.StringSetting this property to true, blocks menuPopup on input elements and shows browser default instead. Default value is false.
displayListenerfalsefalsejava.lang.StringThe displayListener is a MethodBinding/MethodExpression that specifies a method on a backing bean that will accept a com.icesoft.faces.component.DisplayEvent.
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.

hideOnfalsefalsejava.lang.String

The following are the valid values for the hideOn attribute:

  • mouseout
  • mousedown

mouseout :

the popup menu will be hidden when the user moves the mouse out of any part of the menu.

mousedown :

the popup menu will be hidden when the user clicks any area outside of the menu.

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. For menuPopup, the only valid orientation is vertical, where each subsequent top-level menu item is below the previous. Sub menus appear to the side.
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 iceMnuPop

if enabled
  • iceMnuPopVrt
  • iceMnuPopVrtItem
  • iceMnuPopVrtItemLabel
  • iceMnuPopVrtItemImage
  • iceMnuPopVrtSubMenu
  • iceMnuPopVrtSubMenuInd
if disabled
  • iceMnuPopVrt-dis
  • iceMnuPopVrtItem-dis
  • iceMnuPopVrtItemLabel-dis
  • iceMnuPopVrtItemImage-dis
  • iceMnuPopVrtSubMenu-dis
  • iceMnuPopVrtSubMenuInd-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.