Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup
This document describes the steps needed to refactor the back-office components to use the new menu widget. Steps are to be applied to the menu widget xml files.

...



\----------------------------------------------------\-

...



Delete orientation="horizontal" and orientation="vertical". The menu widget renders a simple unordered list, so the menus are vertical by default. Horizontal menus must be styled with a horizontal menu CSS style (see the maincss.css file). You can specify a horizontal menu style by using the menu-container-style property.

...



Delete default-widget-style, default-tooltip-style.

...



Example - before refactor:

...



<menu name="ProfileTabBar" default-menu-item-name="viewprofile" default-selected-style="tabButtonSelected"

...


&nbsp;&nbsp;&nbsp;&nbsp;default-title-style="tabButton" default-tooltip-style="tooltip" default-widget-style="tabButton"

...


&nbsp;&nbsp;&nbsp;&nbsp;orientation="horizontal" type="simple">

...


&nbsp;&nbsp;&nbsp;&nbsp;...

...


</menu>

...



Example - after refactor:

...



<menu name="ProfileTabBar" default-menu-item-name="viewprofile" default-selected-style="selected"

...


&nbsp;&nbsp;&nbsp;&nbsp;type="simple" menu-container-style="button-bar button-style-1">

...


&nbsp;&nbsp;&nbsp;&nbsp;...

...


</menu>
\\

h2. Using framework-defined menu templates

Two menus have been defined in the common framework component and are intended to be "extended" in all applications in order to reduce the code and improve UI consistency all over OFBiz.

*{+}CommonAppBarMenu{+}*
This should be used for every Application menu bar with a definition like this:


_<menu name="ExampleAppBar" title="${uiLabelMap.ExampleApplication}" extends="CommonAppBarMenu" extends-resource="component://common/widget/CommonMenus.xml">_

This menu already defines the "main", "login" and "logout" menu items to their standard URI.

*{+}CommonTabBarMenu{+}*
This should be used for every Application tab bar menu with a definition like this:

_<menu name="exampleTabBar" extends="CommonTabBarMenu" extends-resource="component://common/widget/CommonMenus.xml">_


&nbsp;\\