Submenu

Overview

Since 3.0

The <ace:submenu> tag is used inside menu components for grouping related menu items.

See the ICEfaces Showcase Live Demo of this component, complete with source code.

Getting Started

The <ace:submenu> tag is to be nested inside <ace:menu>, <ace:menuBar> or <ace:contextMenu> tags.

<ace:menu>
	<ace:submenu label="Actions">
		<ace:menuItem value="Action One" />
		<ace:menuItem value="Action Two" />
	</ace:submenu>
</ace:menu>

Attributes

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.

label Sets the label of the submenu.

icon Sets the CSS class name that contains the styling to display an icon.

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.

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.

<ace:ajax/> support

There's no specific ajax support for the submenu. Use the menu item ajax capabilities instead.

JavaScript APIs / Client Behaviours

Not applicable.

Keyboard and ARIA support

The various menu components can be navigated with the arrow keys. There is no specific ARIA support for submenus.

CSS Classes

Submenus are rendered in different ways by their parent components. Please refer to the documentation related to ContextMenu and Menu and Menubar for more information.

Known Issues

None.

Other Resources