ICEfaces ACE Components
Tag menuItem


MenuItem is used by various menu components

For more information, see the MenuItem Wiki Documentation.


Client Events
NameDescriptionSupported Classes for ArgumentDefault Event Scopes
actionTriggers when the menu item is clicked or selected by any other means.javax.faces.event.AjaxBehaviorEventexecute=@this render=@all
Client events can be used with Client Behaviors and the ace:ajax tag.


Tag Information
Tag Classorg.icefaces.ace.component.menuitem.MenuItemTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
accesskeynotruejava.lang.StringAccess key that, when pressed, transfers focus to this component.
actionnotruejavax.el.MethodExpressionMethodExpression representing the application action to invoke when this component is activated by the user. The expression must evaluate to a public method that takes no parameters, and returns an Object (the toString() of which is called to derive the logical outcome) which is passed to the NavigationHandler for this application.
actionListenernotruejavax.el.MethodExpressionMethodExpression 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, or to a public method that takes no arguments with a return type of void. In the latter case, the method has no way of easily knowing where the event came from, but this can be useful in cases where a notification is needed that "some action happened".
bindingnotruejavax.el.ValueExpressionUsing an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
disablednotruebooleanBoolean value to disable/enable the menu item. The menu item will still be shown but with different styling, and clicking on it will not trigger any action.
helpTextnotruejava.lang.StringText to display additional information. The text appears as a standard browser tooltip.
iconnotruejava.lang.StringCSS class name(s) containing the styling to display an icon.
idnotruejava.lang.StringThe component identifier for this component. This value must be unique within the closest parent component that is a naming container.
immediatenotruebooleanFlag indicating that, if this component is activated by the user, notifications should be delivered to interested listeners and actions immediately (that is, during Apply Request Values phase) rather than waiting until Invoke Application phase. Default = 'false'.
onclicknotruejava.lang.StringJavascript event handler for click event. If this function explicitly returns 'false', then the request to the server will be cancelled.
outcomenotruejava.lang.StringThe outcome, used by the navigation handler to determine the target view when the component is rendered. This attribute overrides the "url" attribute. Also, f:param tags can be nested inside this component when using this attribute.
renderednotruebooleanReturn true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
stylenotruejava.lang.StringStyle of the menuitem label.
styleClassnotruejava.lang.StringStyleClass of the menuitem label.
targetnotruejava.lang.StringTarget type of url navigation.
urlnotruejava.lang.StringUrl to be navigated when menuitem is clicked.
urlEncodingnotruejava.lang.StringSpecifies the encoding type for value of the 'url' attribute. Possible values are "resource", "action", "partialaction", "bookmarkable", "redirect", and "none". For all encodings other than "resource" and "none" the URL must be relative to the context path and must start with '/'. For external links and to render the value of the 'url' attribute unmodified use "none". Default = 'resource'.
urlParametersnotruejava.util.MapSpecifies an optional map of parameters to use when encoding URLs of the "bookmarkable" and "redirect" types. The value of this attribute must evaluate to an object of type Map>.
valuenotruejava.lang.ObjectThe current value of the simple 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.