Summary
Tag name: <t:navigationMenuItem>
UIComponent class: org.apache.myfaces.custom.navmenu.UINavigationMenuItem
Tag class: org.apache.myfaces.custom.navmenu.HtmlNavigationMenuItemTag
Component type: org.apache.myfaces.NavigationMenuItem
Component family: javax.faces.SelectItem
A menu item. Used by navigationMenu, jscookMenu.
Unless otherwise specified, all attributes accept static values or EL expressions.
Attributes
| Name | Type | Supports EL? | Description |
|---|---|---|---|
| action | javax.faces.el.MethodBinding | Yes | Specifies the action to take when this command is invoked. If the value is an expression, it is expected to be a method binding EL expression that identifies an action method. An action method accepts no parameters and has a String return value, called the action outcome, that identifies the next view displayed. The phase that this event is fired in can be controlled via the immediate attribute. If the value is a string literal, it is treated as a navigation outcome for the current view. This is functionally equivalent to a reference to an action method that returns the string literal. |
| actionListener | javax.faces.el.MethodBinding | Only EL | A method binding EL expression that identifies an action listener method to be invoked if this component is activated by the user. An action listener method accepts a parameter of type javax.faces.event.ActionEvent and returns void. The phase that this event is fired in can be controlled via the immediate attribute. |
| binding | String | Only EL | Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. |
| disabled | boolean | Yes | When set instead of a Hyperlink a span tag is rendered in the corresponding Component |
| disabledStyle | String | Yes | CSS-Style Attribute to render when disabled is true |
| disabledStyleClass | String | Yes | CSS-Style Class to use when disabled is true |
| enabledOnUserRole | String | Yes | If user is in given role, this component will be rendered normally. If not, no hyperlink is rendered but all nested tags (=body) are rendered. |
| icon | String | Yes | |
| id | String | Yes | An identifier for this particular component instance within
a component view.
The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted. |
| itemDescription | String | Yes | An optional description for this item. For use in development tools. |
| itemDisabled | boolean | Yes | Determine whether this item can be chosen by the user. |
| itemLabel | String | Yes | Get the string which will be presented to the user for this option. |
| itemValue | Object | Yes | The value of this item, of the same type as the parent component's value. |
| rendered | boolean | Yes | A boolean value that indicates whether this component should be rendered. Default value: true. |
| split | boolean | Yes | |
| target | String | Yes | |
| value | Object | Yes | An EL expression that refers to a javax.faces.model.SelectItem instance. |
| visibleOnUserRole | String | Yes | If 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. |