You see the Properties window for an Menu Component when you select the component on a page that you are editing in the Visual Designer. Most of the component's properties are both JSP attributes and properties of the Menu Java component in the page bean.
This JavaServer Faces 1.2 component has the following properties.
General
id. Type: String
The name of the Menu Component in the page bean and the JSP file.
Appearance
style. Type: String
Cascading Style Sheet rules (CSS level 2) to be applied to the component. For example:
position: absolute; left: 288px; top: 312px
You can enter values directly or click the ellipsis (...) button to use the Style Editor.
This property overrides any settings in the theme or the project CSS file for this component. If a style specified in this property does not appear to take effect, it is because an area of the component is obscured by a child component that has different style settings.
For a list of CSS2 style attributes, see the web page at
styleClass. Type: String A space-separated list of CSS2 style classes to be applied when the component is rendered. The style classes must be defined in the project's style sheet or in the theme's CSS file. If you click the ellipsis button (...), you see a list of all styles you can add to this property. For information on adding CSS classes and rules to the project's cascading style sheet, see CSS Editor.
See the note above under the style property description for an explanation of why a class added to this property might appear to have no effect on the component.
If you add a CSS style class from the current theme to your project CSS file and you redefine the style class, the change affects all components that use this style class. However, you can add your own style classes to the project CSS file that redefine the default style classes, and then when you add them to this property, the changes affect only this instance of this component.
Data
items. Type: String
Specifies the items that the web application user can choose from. The value must be one of an array, Map, or Collection whose members are all subclasses of com.sun.webui.jsf.model.Option.
Behavior
immediate. Type: Boolean
The immediate flag.
submitForm. Type: Boolean
When the submitForm attribute is set to true, the form is immediately submitted when the user changes the selection in the menu.
visible. Type: Boolean Use the visible attribute to indicate whether the component should be viewable by the user in the rendered HTML page. If set to false, the HTML code for the component is present in the page, but the component is hidden with style attributes. By default, visible is set to true, so HTML for the component HTML is included and visible to the user. If the component is not visible, it can still be processed on subsequent form submissions because the HTML is present.
JavaScript
onChange. Type: String
Scripting code executed when the element value of this component is changed.
onClick. Type: String
Scripting code executed when a mouse click occurs over this component.The Menu element has a function called getSelectedOption which can be invoked by onClick function handlers to know which option has been selected. This will return the name of the option that was clicked.
onDblClick. Type: String
Scripting code executed when a mouse double click occurs over this component.
onKeyDown. Type: String
Scripting code executed when the user presses down on a key while the component has focus.
onKeyPress. Type: String
Scripting code executed when the user presses and releases a key while the component has focus.
onKeyUp. Type: String
Scripting code executed when the user releases a key while the component has focus.
onMouseDown. Type: String
Scripting code executed when the user presses a mouse button while the mouse pointer is on the component.
onMouseMove. Type: String
Scripting code executed when the user moves the mouse pointer while over the component.
onMouseOut. Type: String
Scripting code executed when a mouse out movement occurs over this component.
onMouseOver. Type: String
Scripting code executed when the user moves the mouse pointer into the boundary of this component.
onMouseUp. Type: String
Scripting code executed when the user releases a mouse button while the mouse pointer is on the component.
Advanced
phaseId. Type: String
The PhaseId in which events should be broadcast. The default is PhaseId.INVOKE_APPLICATION or PhaseId.ANY if Immediate returns true.
rendered. Type: Boolean
If selected, the component is to be rendered and processed on any subsequent page submission. If not selected, the component does not appear on the page at all, not even as a hidden component. If you need the component to be hidden but still processed when the page is submitted, deselect the visible property instead of this property.