Menu"

From Documentation
m (correct highlight (via JWB))
 
(15 intermediate revisions by 7 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 =
  
Space is a Separator with the orient default to "horizontal".
+
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>
  
In other words, <space> is equivalent to <separator orient="horizontal">
+
= Example =
 +
[[Image:ZKComRef_Menu.png]]
  
  
 +
<source lang="xml" >
 +
<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>
 +
</source>
  
= Example =
+
= 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>
 +
</source>
  
 +
=Supported Events=
  
 
+
{| class='wikitable' | width="100%"
=Supported events=
 
 
 
{| border="1" | width="100%"
 
 
! <center>Name</center>
 
! <center>Name</center>
 
! <center>Event Type</center>
 
! <center>Event Type</center>
Line 30: 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
 
|-
 
|-
| 5.0+
+
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
Line 46: Line 73:
  
 
=Version History=
 
=Version History=
 
+
{{LastUpdated}}
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-
| 5.x.x
+
| &nbsp;
| x/x/20xx
+
| &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.