====== behavior: menu-bar ======
Top level menu


===== Elements =====
There are no elements that have this behavior applied by default.
In principle any element - block container - can use this behavior and so to serve as a top-level menu.
See sdk/menu/menu-bar.htm for example of such menu bar.

:!: Menu items: immediate children of the element with ''behavior:menu-bar'' applied are treated as menu items if they are:
    *  either of type ''<li>'' 
    *  or have attribute ''role="menu-item"''
    *  and not disabled.

Menu items may have sub-menus that are shown as popup windows. Typical structure is:
<code html>
  <ul #menu-bar>
     <li>Menu item with sub-menu
         <menu #sub-menu> 
            <li>Open</li>
            <li>Close</li>
         </menu>
     </li>
     <li>Simple menu item (no submenu)</li>
  </ul>
</code>

===== Attributes =====
This behavior does not use any special attributes.

===== Events =====
Together with the standard set of events (mouse, keyboard, focus) //behavior: menu-bar// generates:
    *  MENU_ITEM_ACTIVE event - mouse is over some menu item. ''target'' parameter of the event structure is the active menu item.
    *  MENU_ITEM_CLICK event - menu item clicked. ''target'' parameter of the event structure is the menu item clicked.