home / documentation / reference / menuclass

MenuClass

Description:

The CSS class name that should be applied to this menu.

Value:

String, "", or JavaScript expression that returns a string/"". MenuClass should match an existing class name in a user-defined CSS style sheet elsewhere on the HTML page.

Applies To:

Menus.

Browser Compatibility:

MenuClass is not supported in Netscape 4.x.

Comments:

MenuClass, along with the item and 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 MenuClass, you must first define a class in your style sheets. You can then apply that class name to your menus using the MenuClass 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.

Dimensioning parameters, including width, height, padding, and border widths, should not be included in your CSS class definition. If you use these, the results will generally be undesirable (or they will just be ignored by HierMenus).

Those stylings that you provide in your style sheet class that are automatically inherited by contained items will automatically be applied to menu items and buttons within the menu, making MenuClass an excellent location for those settings that are shared on all items of the menu, such as font familes, sizes, and styles.

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.

MenuClass is case sensitive.

Examples:

// Ok:
MenuClass:"hm_menus",
MenuClass:(window.useClasses)?"hm_menus":"",
   // if the user defined variable "useClasses" is
   // true, use the classname hm_menus

// Incorrect:
MenuClass:hm_menus,         // quotes required
MenuClass:'(window.useClasses)?"hm_menus":""',
   // no quoted expressions

Default:

""

See Also:

ItemClass, ItemClassOver, ItemClassSelected, ButtonClass, ButtonClassOver, ButtonClassSelected, Using Classes Mini-Tutorial