Menu

Menu

• Demonstration: Menu
• Java API: org.zkoss.zul.Menu
• JavaScript API: zul.menu.Menu
• Style Guide: Menu in Menubar, Menu in Menupopup

Employment/Purpose

An element, much like a button, is placed on a menu bar. When the user clicks the menu element, the child Menupopup of the menu will be displayed. This element is also used to create submenus of Menupopup.

Example

<menubar>
 <menu label="File">
     <menupopup>
         <menuitem label="New" onClick="alert(self.label)"/>
         <menuitem label="Open" onClick="alert(self.label)"/>
         <menuitem label="Save" onClick="alert(self.label)"/>
         <menuseparator/>
         <menuitem label="Exit" onClick="alert(self.label)"/>
     </menupopup>
 </menu>
</menubar>

Properties

onClick

If we take a look at the screenshot of the Menu below both the right hand side and left hand side have been outlined in red. Clicking the arrow on the right hand side will show the menu whereas clicking the main button (the left hand side) will fire the onClick event. The red outline is used to highlight the clickable areas of the Menu.

The code to register an onClick event is shown below:

<menubar>
    <menu label="Topmost" onClick='alert(1);'>
        <menupopup>
            <menuitem label="test"/>
        </menupopup>
    </menu>
</menubar>

Supported Events

Name	Event Type
None	None

• Inherited Supported Events: LabelImageElement

Supported Children

* Menupopup

Use Cases

Version	Description	Example Location

Version History

Version	Date	Content