Submenu

compared with
Current by Arturo Zambrano
on Dec 11, 2014 02:57.


 
Key
These lines were removed. This word was removed.
These lines were added. This word was added.

View page history


There are 1 changes. View first change.

 h2. Overview
 _Since 3.0_
  
 The {{<ace:submenu>}} tag is used inside menu components for grouping related menu items.
  
 {tip}See the ICEfaces Showcase [Live Demo|http://icefaces-showcase.icesoft.org/showcase.jsf?grp=aceMenu&exp=menuBean] of this component, complete with source code.{tip}
  
 h2. Getting Started
 The {{<ace:submenu>}} tag is to be nested inside {{<ace:menu>}}, {{<ace:menuBar>}} or {{<ace:contextMenu>}} tags.
 {panel}
 {code:xml|borderStyle=dashed}
 <ace:menu>
  <ace:submenu label="Actions">
  <ace:menuItem value="Action One" />
  <ace:menuItem value="Action Two" />
  </ace:submenu>
 </ace:menu>
 {code}
 {panel}
  
 h2. Attributes
 {tip:title=TagLib Documentation}This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://www.icefaces.org/docs/v4_latest/ace/tld/ace/submenu.html].{tip}
 {panel}
 *label* Sets the label of the submenu.
 {panel}
 {panel}
 *icon* Sets the CSS class name that contains the styling to display an icon.
 {panel}
  
 {panel}
 *positionTop* Specifies a 'top' position (in pixels) that will override the automatic positioning of the submenu. This value is relative to the 'top' position of the submenu label or of the menu bar (see 'relativeTo' attribute). A negative value means that this custom position is above the reference point, while and positive value means that this custom position is below.
 {panel}
 {panel}
 *positionLeft* Specifies a 'left' position (in pixels) that will override the automatic positioning of the submenu. This value is relative to the 'left' position of the submenu label or of the menu bar (see 'relativeTo' attribute). A negative value means that this custom position is to the left the reference point, while and positive value means that this custom position is to the right.
 {panel}
  
 h2. <ace:ajax/> support
  
 There's no specific ajax support for the submenu. Use the [menu item|http://wiki.icefaces.org/display/ICE/MenuItem] ajax capabilities instead.
  
 h2. JavaScript APIs / Client Behaviours
  
  Not supported at the moment. See the [menu item|http://wiki.icefaces.org/display/ICE/MenuItem] documentation for other options.
  Not applicable.
  
 h2. Keyboard and ARIA support
  
 The various menu components can be navigated with the arrow keys. There is no specific ARIA support for submenus.
  
 h2. CSS Classes
  
 Submenus are rendered in different ways by their parent components. Please refer to the documentation related to [ContextMenu|http://www.icesoft.org/wiki/display/ICE/ContextMenu] and [Menu and Menubar|http://www.icesoft.org/wiki/display/ICE/Menu+and+Menubar] for more information.
  
 h2. Known Issues
  
 None.
  
 h2. Other Resources
  
 None.

© Copyright 2018 ICEsoft Technologies Canada Corp.