Menu"

From Documentation
m (correct highlight (via JWB))
 
(7 intermediate revisions by 4 users not shown)
Line 6: Line 6:
 
*Java API: <javadoc>org.zkoss.zul.Menu</javadoc>
 
*Java API: <javadoc>org.zkoss.zul.Menu</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zul.menu.Menu</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zul.menu.Menu</javadoc>
*Style Guide: [http://books.zkoss.org/wiki/ZK_Style_Guide/XUL_Component_Specification/Menubar/Menu_in_Menubar Menu in Menubar], [http://books.zkoss.org/wiki/ZK_Style_Guide/XUL_Component_Specification/Menupopup/Menu_in_Menupopup Menu in Menupopup]
+
*Style Guide: [[ZK_Style_Guide/XUL_Component_Specification/Menubar/Menu_in_Menubar| Menu in Menubar]], [[ZK_Style_Guide/XUL_Component_Specification/Menupopup/Menu_in_Menupopup| Menu in Menupopup]]
  
 
= Employment/Purpose =
 
= Employment/Purpose =
  
An element, much like a button, that is placed on a menu bar. When the user clicks the menu element, the child <tt>Menupopup</tt> of the menu will be displayed. This element is also used to create submenus of <tt>Menupopup</tt>.<tt> </tt>
+
An element, much like a button, is placed on a menu bar. When the user clicks the menu element, the child <code>Menupopup</code> of the menu will be displayed. This element is also used to create submenus of <code>Menupopup</code>.<code> </code>
  
 
= Example =
 
= Example =
Line 27: Line 27:
 
     </menupopup>
 
     </menupopup>
 
  </menu>
 
  </menu>
 +
</menubar>
 +
</source>
 +
 +
= 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.
 +
 +
[[Image:ZKComRef_Menu_onClick.png]]
 +
 +
The code to register an onClick event is shown below:
 +
<source lang="xml" highlight="2">
 +
<menubar>
 +
<menu label="Topmost" onClick='alert(1);'>
 +
<menupopup>
 +
<menuitem label="test"/>
 +
</menupopup>
 +
</menu>
 
</menubar>
 
</menubar>
 
</source>
 
</source>
Line 32: Line 49:
 
=Supported Events=
 
=Supported Events=
  
{| border="1" | width="100%"
+
{| class='wikitable' | width="100%"
 
! <center>Name</center>
 
! <center>Name</center>
 
! <center>Event Type</center>
 
! <center>Event Type</center>
Line 47: Line 64:
 
=Use Cases=
 
=Use Cases=
  
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Description !! Example Location
 
! Version !! Description !! Example Location
 
|-
 
|-
Line 56: Line 73:
  
 
=Version History=
 
=Version History=
 
+
{{LastUpdated}}
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-

Latest revision as of 09:22, 18 January 2022

Menu

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

ZKComRef Menu.png


<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.

ZKComRef Menu onClick.png

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

Supported Children

* Menupopup

Use Cases

Version Description Example Location
     

Version History

Last Update : 2022/01/18


Version Date Content
     



Last Update : 2022/01/18

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.