View Source

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