Menu

Consists of three classes: Menu, MenuBar, and MenuItem.

• Menu refers to the entire component.

• MenuItem is a leaf, or node, that corresponds to a tab on the first or second level.

• MenuBar corresponds to a tab that contains MenuBars, or MenuItems.

Menu contains the following properties:

• layout - A String with value horizontal or vertical. A value of horizontal generates a horizontal navigation bar with tabs. A value of vertical causes the menu to be rendered as a vertical tree menu with typical node layout.

• stylePrefix - String prefix for the CSS class name. For the Waveset End User pages, this value is User.

MenuBar contains the following properties:

• default - A String URL path that corresponds to one of the MenuBar’s MenuItem URL properties. This controls which subtab is displayed as selected by default when the MenuBar tab is clicked.

MenuItem contains the following properties:

• containedUrls - A List of URL path(s) to JSPs that are ”related” to the MenuItem. The current MenuItem will be rendered as “selected”if any of the containedUrls JSPs are rendered. An example is the request launch results page that is displayed after a workflow is launched from the request launch page.

You can set these properties on either a MenuBar or MenuItem:

• title - Specifies the text String displayed in the tab or tree leaf as a hyperlink

• URL - Specifies the String URL path for the title hyperlink

The following XPRESS example creates a menu with two tabs. The second tab contain two subtabs:

Example 7–1 Implementation of Menu, MenuItem, and MenuBar Components

<Display class=’Menu’/> 
<Field> 
   <Display class=’MenuItem’> 
      <Property name=’URL’ value=’user/main.jsp’/> 
      <Property name=’title’ value=’Home’ /> 
   </Display> 
</Field> 
<Field> 
   <Display class=’MenuBar’ > 
      <Property name=’title’ value=’Work Items’ /> 
      <Property name=’URL’ value=’user/workItemListExt.jsp’ /> 
   </Display> 
   <Field> 
      <Display class=’MenuItem’> 
         <Property name=’URL’ value=’user/workItemListExt.jsp’/> 
         <Property name=’title’ value=’Approvals’ /> 
      </Display> 
   </Field> 
   <Field> 
      <Display class=’MenuItem’> 
         <Property name=’URL’ value=’user/otherWorkItems/listOtherWorkItems.jsp’/> 
         <Property name=’title’ value=’Other’ /> 
      </Display> 
   </Field> 
</Field>

In the Waveset User Interface, the horizontal navigation bar is driven by the End User Navigation User form in enduser.xml.

The userHeader.jsp, which is included in all Waveset User Interface pages, includes another JSP named menuStart.jsp. This JSP accesses two system configuration objects:

• ui.web.user.showMenu - Toggles the display of the navigation menu on/off (default is true).

• ui.web.user.menuLayout - Determines whether the menu is rendered as a horizontal navigation bar with tabs (the default value is horizontal) or a vertical tree menu (vertical).

style.css contains the CSS style classes that determine how the menu is rendered.