Menu properties

Purpose

Specifies the style, order, orientation, and use of text an images of menus and menuitems.

Note:

The Menu Item Iterator Allocation property is not supported for the deprecated row and column iterator formats.

Controls

Control Description Options Property
Style Sets the style of the menu. dynamic, static  theme_menu_prop.html#mcs-menu-image-style
Link Style Specifies the style of menu to use. If the value is set to 'numeric-shortcut', MCS renders the menu with numeric identifiers for each menuitem. Otherwise, the default style for the device applies. default, numeric-shortcut  theme_menu_prop.html#mcs-menu-link-style
Image Style Specifies how images are used in menuitems. none, plain, rollover  theme_menu_prop.html#mcs-menu-image-style
Text Style Specifies how text is used in menuitems. none, plain  theme_menu_prop.html#mcs-menu-text-style
Orientation Controls the orientation of menuitems and shard links. The value of 'horizontal' allows optional separators between items. horizontal, vertical  theme_menu_prop.html#mcs-menu-orientation
Menu Item Iterator Allocation Specifies how the menuitems will be bound to instances of a pane in a spatial iterator. The value of 'automatic' writes a menuitem to each instance of pane; 'none' writes only to the first instance of the pane. automatic, none  theme_menu_prop.html#mcs-menu-item-iterator-allocation
Menu Item Order The order in which image and text menuitems are used when both are present. image-first, text-first  theme_menu_prop.html#mcs-menu-item-order
Menu Item Orientation The orientation of the contents of a menuitem when more than one item is present. Some combinations of menu orientation and this property may not be supported on every protocol. horizontal, vertical  theme_menu_prop.html#mcs-menu-item-orientation
Menu Item Active Area Specifies whether an image, text or both are active when both are present. Only one image style and one text style can be shown in a single menuitem. both, image-only, text-only theme_menu_prop.html#mcs-menu-item-active-area
Menu Item Shortcut Active Specifies whether or not shortcuts are active for the menuitems in a menu. active, inactive  theme_menu_prop.html#mcs-menu-item-shortcut-active

Properties

mcs-menu-style

Sets the style of the menu. The default value is 'static'.

Option Description
dynamic Indicates that the menu is dynamic.
static Indicates that the menu is static.
inherit The value of the property should be inherited from the parent element.
mcs-menu-image-style

Specifies how images are used in menuitems. The default value is 'none'.

Option Description
none Indicates that the image information in each menuitem should be ignored.
plain Indicates that the static image information in each menuitem should be used in creating the menu.
rollover Indicates that the rollover image information in each menuitem should be used in creating the menu.
inherit The value of the property should be inherited from the parent element.
mcs-menu-item-active-area

Specifies whether an image, text or both are active when both are present. Only one image style and one text style can be shown in a single menuitem. The default value is 'both'.

Option Description
both Indicates that when both image and text information is being used in each menuitem, they should both be active.
image-only Indicates that when both image and text information is being used in each menuitem, only the image should be active.
text-only Indicates that when both image and text information is being used in each menuitem, only the text should be active.
inherit The value of the property should be inherited from the parent element.
mcs-menu-item-iterator-allocation

Specifies how the menuitems will be bound to instances of a pane in a spatial iterator. The default value is 'none'.

Option Description
automatic Each menuitem that will be output to the pane referenced by the menu will be written to a separate instance of that pane within the spatial iterator.
none Every menuitem that will be output to the pane referenced by the menu will be written to the first instance of the pane within the spatial iterator.
inherit The value of the property should be inherited from the parent element.
mcs-menu-item-order

Sets the order in which image and text menuitems are used when both are present. The default value is 'image-first'.

Option Description
image-first Indicates that when both image and text information is being used in each menuitem, the image information should appear before the text information.
text-first Indicates that when both image and text information is being used in each menuitem, the text information should appear before the image information.
inherit The value of the property should be inherited from the parent element.
mcs-menu-item-orientation

Defines the orientation of the contents of a menuitem when more than one item is present. Some combinations of menu orientation and this property may not be supported on every protocol. The default value is 'horizontal'.

Option Description
horizontal Indicates that when both image and text information is being used in each menuitem, they should be oriented horizontally.
vertical Indicates that when both image and text information is being used in each menuitem, they should be oriented vertically.
inherit The value of the property should be inherited from the parent element.
mcs-menu-item-shortcut-active

Specifies whether or not shortcuts are active for the menuitems in a menu. The default value is 'active'.

Option Description
active Indicates that the shortcut (and the associated separator) will be active, i.e. it will be inside the link.
inactive Indicates that the shortcut (and the associated separator) will be inactive, i.e. it will be outside the link.
inherit The value of the property should be inherited from the parent element.
mcs-menu-link-style

Specifies the style of menu to use. The default value is 'default'.

Option Description
default The menu will be shown in the default style for the device. The menu items will be rendered according to the menu item specific properties.
numeric-shortcut The menu will be rendered with numeric identifiers for each menu item. These identifiers provide a shortcut key for that menu item.
inherit The value of the property should be inherited from the parent element.
mcs-menu-orientation

Specifies the orientation of menuitems and shard links. The default value is 'vertical'.

Option Description
horizontal The menu is to be generated horizontally with an optional separator between each item.
vertical The menu is to be generated vertically with one item per line.
inherit The value of the property should be inherited from the parent element.
mcs-menu-text-style

Specifies how text is used in menuitems. The default value is 'plain'.

Option Description
none Indicates that the text information in each menuitem is to be ignored.
plain Indicates that the text information in each menuitem is to be used in creating the menu.
inherit The value of the property should be inherited from the parent element.

Example

<?xml version="1.0" encoding="UTF-8"?>
<html xmlns="http://www.w3.org/2002/06/xhtml2"
  xmlns:mcs="http://www.volantis.com/xmlns/2006/01/xdime/mcs">
  <head>
    <title>Menu properties</title>
    <style type="text/css">
      .main-menu {
        mcs-menu-style: dynamic;
        mcs-menu-orientation: horizontal;
        mcs-toggle-event: click;
      }
      label {
        padding-left: 5px;
        padding-right: 5px;
      }
    </style>
  </head>
  <body>
    <nl class="main-menu">
      <label/>
      <li>
        <nl>
          <label>A -R</label>
          <li><a href="http://www.ankara-bel.gov.tr">Ankara</a></li>
          <li><a href="http://www.budapest.hu">Budapest</a></li>
          <li><a href="http://www.ljubljana.si">Ljubljana</a></li>
          <li><a href="http://www.nicosia.org.cy">Nicosia</a></li>
          <li><a href="http://www.rcc.lv">Riga</a></li>
        </nl>
      </li>
      <li>
        <nl>
          <label>S - Z</label>
          <li><a href="http://www.sofia.bg">Sofia</a></li>
          <li><a href="http://www.tallinn.ee">Tallinn</a></li>
          <li><a href="http://www.tirana.gov.al">Tirana</a></li>
          <li><a href="http://www.cityofvalletta.org">Valletta</a></li>
          <li><a href="http://www.wien.gv.at/">Vienna</a></li>
          <li><a href="http://www.vilnius.lt">Vilnius</a></li>
          <li><a href="http://www.zagreb.hr">Zagreb</a></li>
        </nl>
      </li>
    </nl>
  </body>
</html>

Related topics