ICEfaces Tag Reference

Contents

10. ICEfaces Tag Reference

ice:menuItem

The ice:menuItem tag is the menu item 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 as 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.

Example

<ice:menuItem></ice:menuItem>

HTML Output

(No output.)

Rendered Output

Tag Attributes

action	Text

The action attribute accepts a method-binding expression for a backing bean action method to invoke when this component is activated by the user. An action method must be a public method with no parameters that returns a String. The returned string represents the logical outcome of the action (eg. "success", "failure", etc.) and is used by the JavaServer Faces MVC framework to determine which view to display next.

actionListener	Text

The actionListener attribute accepts a method-binding expression for a backing bean action listener method that will be notified when this component is activated by the user. An action listener method must be a public method with an javax.faces.event.ActionEvent parameter and a void return type.

binding	Expression

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

disabled	Boolean

The disabled attribute is a boolean flag that when set to true indicates that this component should not receive focus or be included in a form submit.

enabledOnUserRole	Text

The enabledOnUserRole 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 and will function. If the user does not have a role, then the component will be disabled (will not function) and will be grayed out.

icon	File

The icon attribute sets the icon for this component.

id	Text

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

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.

link	Text

The link attribute sets the link for this component.

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.

styleClass	CSS Class

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

target	Text

The target attribute identifies the name of a frame into which the resource retrieved by this hyperlink should be displayed.

value	Text

The value attribute sets the current value for this component.