ICEfaces Tag Reference

Contents

10. ICEfaces Tag Reference

ice:menuBar

The ice:menuBar tag 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:

* by using a reference to a bean method that returns a (potentially) dynamic heirarchy of menu items

* by statically defining the heirarchy in the JSPX page

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.

Example

<ice:menuBar value="hello" styleClass="foo" orientation="vertical"> 
  <ice:menuItem value="Hello" styleClass="bar"> 
    <ice:menuItem value="Bar" />
  </ice:menuItem>
  <ice:menuItem value="One" />
  <ice:menuItem value="Two" />
  <ice:menuItem value="Three" />
</ice:menuBar>

Rendered Output

Tag Attributes

binding	Expression

The value-binding expression linking this component tag to a backing bean property.

id	Text

The unique identifier value for this component. The value must be unique within the closest naming container.

imageDir	Text

The imageDir attribute sets the directory location of the tree images. The default directory is /xmlhttp/css/xp/css-images/ which is include in the icefaces.jar.

immediate	Boolean

The immediate attribute is a boolean flag indicating that component events should be sent to registered event listeners immediately rather than after the validation phase of the JSF request processing lifecycle. The immediate flag allows you bypass JSF validation for a particular component.

noIcons	Boolean

The noIcons attribute is a boolean flag that when set to "true", this component will not render icons and icon spacers in menuItems. The default is "false", so that icons are rendered.

orientation	Enumerated

The orientation attribute sets whether the submenus of the top-level menu items appear beside or below the top-level menu items.

rendered	Boolean

A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.

renderedOnUserRole	Text

The renderedOnUserRole attribute is a boolean flag that when set to "true" and if a role has been configured for the user, then the component will be displayed. If the user does not have a role, then the component will not be displayed.

style	CSS Style

The style attribute sets the CSS style definition to be applied to this component when it is rendered.

styleClass	CSS Class

The styleClass attribute sets the CSS class to apply to this component when it is rendered.

value	Text

The value attribute sets the current value for this component.