Overview
SlideMenu provides a navigation panel consisting of multiple sliding panes, like
the Outlook Bar in Microsoft Outlook.
SlideMenu Basics
SlideMenu is derived from
Menu and inherits many Menu's functionalities. The title of each pane
is a top level menu item. The content of each pane is the sub menu of that top
level item. Instead of displaying the sub menu as a popup, SlideMenu displays
the sub menu inside the sliding pane. To customize the pane titles, you should
customize the top level menu items. To customize the content of each pane, you
should customize the sub menu of each top level navigation items.
Important Properties
The following table lists all the important SlideMenu properties:
|
Properties |
Comments |
| SingleExpand
|
Specifies whether only one pane is allowed to expand at any time. The
default value is true.
|
|
SlideEffectType &
SlideEffectDuration
|
Specifies the effect played when pane expands or collapses.
|
| SlidePaneHeight
|
Specifies the height of the sliding pane. This property must be set when
SingleExpand property is true.
When SingleExpand is false, SlidePaneHeight
property is ignored. You may want to add extra paddings to the sliding pane in
this case, set MenuGroup.Style.Paddings
property on the corresponding group object.
|
| ExpandEmptyPane |
Specifies whether empty pane should be expanded when clicked. By default, if a
sliding pane does not have child items, it will not expand when clicked. Set
this property to True causes such the sliding pane to expand even if
it's empty.
|
Note that since SlideMenu is inherited from Menu,
it inherits all Menu properties/methods, which are not listed
here.
Scrolling feature
As Menu, SlideMenu also supports automatic and forced scrolling feature on
popped up submenus. In addition, EO.Web SlideMenu also supports scrolling on
sliding panes.
To enable automatic scrolling feature on popped up submenus, you must set the
SlideMenu's EnableScrolling
property to true.
To enable forced scrolling feature on popped up submenus, you must also specify
the menu group's Height property
so that when the height exceeds, scroller will appear.
Unlike Menu, the 2nd level item group of a SlideMenu renders as the static
content of the sliding pane, not a popup submenu. Hence you must take extra
precaution when you try to enable forced-scrolling on the 2nd level menu group.
The height of the 2nd level item group is determined by multiple properties of
the SlideMenu. The following steps will help you configure scrolling behavior
on 2nd level menu group:
-
Set SlideMenu's EnableScrolling
property to true.
-
If the SlideMenu's SingleExpand
property is set to true, you need to set the SlideMenu's
SlidePaneHeight
property to a fixed value to enable the forced-scrolling on the 2nd level menu.
-
-OR-
If the SlideMenu's SingleExpand
property is set to false, you need to set the 2nd level menu
group'sHeight property
to a fixed value to enable the forced-scrolling on the 2nd and other non-top
levels.
For the other levels, SlideMenu behaves as Menu regarding to scrolling
functionality. You can refer to Scrolling
Feature for basic information.