commandMenuItem

Summary

Tag name: < af:commandMenuItem >

UIComponent class: oracle.adf.view.faces.component.core.nav.CoreCommandMenuItem

Component type: oracle.adf.CoreCommandMenuItem

The commandMenuItem control creates a a menu item representation of a UIXCommand. The item could be rendered as a link, an option, a button, etc. This component is normally used as a stamp for a component that takes a MenuModel object.

Example:

     
            <af:page var="foo" value="#{menu.menuModel}"
                     title="Title attribute">
              <f:facet name="nodeStamp">
                <af:commandMenuItem text="#{foo.label}" action="#{foo.action}"/>
              </f:facet> 
            </af:page>

Events

Type Phases Description

javax.faces.event.ActionEvent Invoke Application

Apply Request Values Event delivered when the "action" of the component has been invoked; for example, by clicking on a button. The action may result in page navigation.

oracle.adf.view.faces.event.ReturnEvent Apply Request Values Event delivered when the dialog has completed successfully.

oracle.adf.view.faces.event.LaunchEvent Invoke Application

Apply Request Values Event delivered to prompt the command to launch a dialog.

Attributes

Ungrouped attributes

Name	Type	Supports EL?	Description
accessKey	char	Yes	Character used to gain quick access to this item. For accessibility reasons, this functionality is not supported in screen reader mode. If the same access key appears in multiple locations in the same page of output, the rendering user agent will cycle among the elements accessed by the similar keys. This attribute is sometimes referred to as the "mnemonic". The character specified by this attribute must exist in the `Text` attribute of this item instance. If it does not, the user will receive no visual indication of the existence of the accessKey.
action	javax.faces.el.MethodBinding	Yes	a reference to an action method sent by the command component, or the static outcome of an action
actionListener	javax.faces.el.MethodBinding	Only EL	a method reference to an action listener
attributeChangeListener	javax.faces.el.MethodBinding	Only EL	a method reference to an attribute change listener
disabled	boolean	Yes	whether the item should be considered disabled.
icon	String	Yes	a URI specifying the location of a target image.
immediate	boolean	Yes	whether or not data validation - client-side or server-side - should take place when events are generated by this component. When immediate is true, the default ActionListener provided by the JavaServer Faces im plementation should be executed during Apply Request Values phase of the request processing lifecycle, rather than waiting until the Invoke Application phase.
launchListener	javax.faces.el.MethodBinding	Only EL	a method reference to a launch listener
partialTriggers	String[ ]	Yes	the IDs of the components that should trigger a partial update. This component will listen on the trigger components. If one of the trigger components receives an event that will cause it to update in some way, this component will request to be updated too.
readOnly	boolean	Yes	whether the item should be rendered as readOnly. Depending on the renderer the text may or may not appear when readOnly is true.
returnListener	javax.faces.el.MethodBinding	Only EL	a method reference to an return listener
selected	boolean	Yes	whether the item is selected.
text	String	Yes	the text of the item.
textAndAccessKey	String	Yes	An attribute that will simultaneously set both the "text" and "accessKey" attributes from a single value, using conventional ampersand (' & ') notation. For example, setting this attribute to "T & amp;ext" will set the text to "Text" and the access key to 'e'.
type	String	Yes	Used to indicate that the item should be rendered specially. The acceptable values are "default" and "global".
useWindow	boolean	Yes	whether to use a new window when launching dialogs. This wi ll be consulted any time the command receives a LaunchEvent.
windowHeight	int	Yes	height of the window, if this command is used to launch a window.
windowWidth	int	Yes	width of the window, if this command is used to launch a window.

Core attributes

Name	Type	Supports EL?	Description
binding	oracle.adf.view.faces.component. core.nav.CoreCommandMenuItem	Only EL	a binding reference to store the component instance
id	String	No	the identifier for the component. This must be a valid XML ID, and therefore may not contain whitespace or start with a number. Also, JSF requires that IDs must not contain any colons (":").
inlineStyle	String	Yes	the inline CSS style for this element
rendered	boolean	Yes	whether the bean is rendered. When set to false, no output will be delivered for this bean.
shortDesc	String	Yes	the short description of the bean. This text is commonly used by user agents to display tooltip help text.
styleClass	String	Yes	the CSS style class of the bean.

Javascript attributes

Name	Type	Supports EL?	Description
onclick	String	Yes	an onclick Javascript handler.
ondblclick	String	Yes	an ondblclick Javascript handler.
onkeydown	String	Yes	an onkeydown Javascript handler.
onkeypress	String	Yes	an onkeypress Javascript handler.
onkeyup	String	Yes	an onkeyup Javascript handler.
onmousedown	String	Yes	an onmousedown Javascript handler.
onmousemove	String	Yes	an onmousemove Javascript handler.
onmouseout	String	Yes	an onmouseout Javascript handler.
onmouseover	String	Yes	an onmouseover Javascript handler.
onmouseup	String	Yes	an onmouseup Javascript handler.