home / documentation / reference / bgcolorover

BGColorOver

Description:

The background color assigned when the mouse rolls over the menu item. Also assigned to parent items if their child menus are visible and the item's KeepHilite parameter is set to true.

Value:

String, "", or JavaScript expression that returns a string/"".

Applies To:

Menu Items.

Browser Compatibility:

BGColorOver is supported in all browsers, though not all browsers may recognize all possible CSS values (especially Netscape 4.x). Additionally, be careful with "system specific" colors such as threedhighlight which may cause errors in browsers that don't support them.

Comments:

BGColorOver should be applied as a string, which means the value you supply should always be in quotes. Allowed values for BGColorOver are the same as those allowed in the standard CSS background-color property (see the W3C Specs) and in fact, the value you supply is transferred as is to the JavaScript backgroundColor property for each menu item.

For those browsers that support them, you may also use system specific colors such as threedhighlight or menu. Note, however, that not all platforms recognize such colors; and in fact some platforms will report errors when attempting to use them. Be sure to test system colors extensively before deploying them, and note that you may be able to exclude system colors for a specific browser or platform using conditional parameter assignments. See the DHTML Lab article Accessing the User-Defined System Colors, Part I for further information on system colors.

Examples:

// Ok:
BGColorOver:"blue",
BGColorOver:"#99CCFF",    // #rrggbb
BGColorOver:"",           // use style sheet default
BGColorOver:(HM_IE)?"menu":"black",
      // menu if IE, black otherwise

// Incorrect:
BGColorOver:"greatgreen",  // must be valid color identifier
BGColorOver:red,           // quotes required
BGColorOver:"FFCC99",      // use leading pound (#) with rgb
BGColorOver:'(HM_IE)?"menu":"black"', // no quoted expressions

Default:

"black"

See Also:

FontColor, FontColorSelected, FontColorOver, BGColor, BGColorSelected, IsPermHilite, IsSelected, IsRollover, KeepHilite, Using Classes Mini-Tutorial