Menu"

From Documentation
m
m (correct highlight (via JWB))
 
(11 intermediate revisions by 6 users not shown)
Line 3: Line 3:
 
= Menu =
 
= Menu =
  
*Demonstration: [http://www.zkoss.org/zkdemo/userguide/#t1 Menu Demo]
+
*Demonstration: [http://www.zkoss.org/zkdemo/menu Menu]
 
*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: [[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 =
[[Image:Menu.png]]
+
[[Image:ZKComRef_Menu.png]]
  
  
 
<source lang="xml" >
 
<source lang="xml" >
 +
<menubar>
 
  <menu label="File">
 
  <menu label="File">
 
     <menupopup>
 
     <menupopup>
Line 25: Line 27:
 
     </menupopup>
 
     </menupopup>
 
  </menu>
 
  </menu>
 +
</menubar>
 
</source>
 
</source>
  
=Supported events=
+
= 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.
  
{| border="1" | width="100%"
+
[[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>
 +
</source>
 +
 
 +
=Supported Events=
 +
 
 +
{| class='wikitable' | width="100%"
 
! <center>Name</center>
 
! <center>Name</center>
 
! <center>Event Type</center>
 
! <center>Event Type</center>
Line 36: Line 56:
 
| None
 
| None
 
|}
 
|}
 +
*Inherited Supported Events: [[ZK_Component_Reference/Base_Components/LabelImageElement#Supported_Events | LabelImageElement]]
  
 
=Supported Children=
 
=Supported Children=
  
  *ALL
+
  *[[ZK Component Reference/Essential Components/Menu/Menupopup  | Menupopup]]
  
=Use cases=
+
=Use Cases=
  
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Description !! Example Location
 
! Version !! Description !! Example Location
 
|-
 
|-
Line 52: Line 73:
  
 
=Version History=
 
=Version History=
 
+
{{LastUpdated}}
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-
| 5.0.2
+
| &nbsp;
| 05/11/2010
+
| &nbsp;
| Initialization
+
| &nbsp;
 
|}
 
|}
  
 
{{ZKComponentReferencePageFooter}}
 
{{ZKComponentReferencePageFooter}}

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.