|
home / documentation / reference / buttonclassselected
ButtonClassSelected
- Description:
- The CSS class name that should be applied to this menu item button when its
child menu appears (or if it is specifically marked IsSelected).
- Value:
- String, "", or JavaScript expression that returns a string/"".
ButtonClassSelected should match an existing class name in a user-defined
CSS style sheet elsewhere on the HTML page.
- Applies To:
- Menu Items.
- Browser Compatibility:
- ButtonClassSelected is not supported in Netscape 4.x or Internet Explorer 4.x.
- Comments:
- ButtonClassSelected, along with the menu, item, and other button specific
class name configuration parameters, allows you to supply basic stylings
for your menus (such as font families and sizes, and background/foreground
color schemes) via CSS style sheets external to HierMenus. To use ButtonClassSelected,
you must first define a class in your style sheets. You can then apply that
class name to your menu items using the ButtonClassSelected configuration parameter.
Defining style sheet classes is well beyond the scope of HierMenus documentation.
For further information pertaining to style sheet rules and available parameters,
we refer you to the W3C's Style Sheet
section.
Most dimensioning parameters, including width and height,
should not be included in your CSS button class definition. If you use these, the
results will generally be undesirable (or they will just be ignored by
HierMenus). Unlike the ItemClass and MenuClass settings, however,
you may utilize border and padding widths in your button classes. It is, however,
strongly recommended that your ButtonClass, ButtonClassOver,
and ButtonClassSelected definitions all share the same dimensioning, such
as font sizes, border, and padding widths. HierMenus does not resize menus when
class names are swapped on menu items; if the individual over and selected states
of the menu item are of differing dimensions the menu items may appear distorted
when they are rolled over.
Special care must be taken when using classes with HierMenus to ensure that
HM's own configuration parameters, which are considered to be more specific
than class name assignments, do not override your style sheet settings. For
further details view the Using Classes mini-tutorial.
ButtonClassSelected is assigned to the menu item button when its child menu appears,
i.e., when the menu item button is intended to be displayed in a "selected" state. ButtonClassSelected
will also be applied to parent menu item buttons when the user rolls over a child menu if
the parent menu item's KeepHilite configuration parameter is set to true.
Finally, if the menu item's IsSelected configuration parameter is set to
true, then the menu item button will always appear as if it is in its "selected" state.
ButtonClassSelected is case sensitive.
- Examples:
// Ok:
ButtonClassSelected:"hm_buttonselect",
ButtonClassSelected:"", // remove over class for this item
ButtonClassSelected:(window.useClasses)?"hm_buttonselect":"",
// if the user defined variable "useClasses" is
// true, use the classname hm_buttonselect
// Incorrect:
ButtonClassSelected:hm_buttonselect, // quotes required
ButtonClassSelected:'(window.useClasses)?"hm_buttonselect":""',
// no quoted expressions - Default:
- ""
- See Also:
- MenuClass,
ItemClass,
ItemClassOver,
ItemClassSelected,
ButtonClass,
ButtonClassOver,
Using Classes Mini-Tutorial
|
