home / documentation / reference / buttonclass

ButtonClass

Description:

The CSS class name that should be applied to the menu item button.

Value:

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

Applies To:

Menu Items.

Browser Compatibility:

ButtonClass is not supported in Netscape 4.x or Internet Explorer 4.x.

Comments:

ButtonClass, 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 ButtonClass, you must first define a class in your style sheets. You can then apply that class name to your menu item buttons using the ButtonClass 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.

ButtonClass also has one unique property not shared by any of the other HierMenus class name assignments: its very existence is the signal to HierMenus that a button--an inner container within the menu item--must be created. Without a button class, HierMenus will not make a button within the menu item and no button specific processing (including the application of any ButtonClassOver and/or ButtonClassSelected assignments) will take place.

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.

ButtonClass is case sensitive.

Examples:

// Ok:
ButtonClass:"hm_button",
ButtonClass:"",    // remove class for this item
ButtonClass:(window.useClasses)?"hm_button":"",
   // if the user defined variable "useClasses" is
   // true, use the classname hm_button

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

Default:

""

See Also:

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