Project Documentation

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.el.MethodExpression 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 org.apache.myfaces.custom.navmenu.UINavigationMenuItem 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 Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view.
itemDescription String Yes For use in development tools.
itemDisabled boolean Yes Determine whether this item can be chosen by the user. When true, this item cannot be chosen by the user. If this method is ever called, then any EL-binding for the disabled property will be ignored.
escape boolean Yes The escape setting for the label of this selection item.
itemLabel String Yes The string which will be presented to the user for this option.
itemValue Object Yes The value for this Item.
noSelectionOption boolean Yes Indicate this component represent no selection option. Default value is false.
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 The initial value of this component.
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.