home / documentation / reference / itembackgroundproperties

ItemBackgroundProperties

Description:

The additional CSS properties to be applied to the ItemBackgroundImage.

Value:

null, or valid CSS background properties, enclosed in quotes.

Applies To:

Menu Items.

Browser Compatibility:

ItemBackgroundProperties is not supported in Netscape 4.x or 6.0x. CSS support for individual background properties may vary from browser to browser.

Comments:

ItemBackgroundProperties can be used to pass additional CSS properties pertaining to the ItemBackgroundImage, such as left or repeat-x, to the CSS background property of the menu. Such parameters complement the ItemBackgroundImage itself and typically provide further instructions to the browser pertaining to the exact placement and behavior of the background image.

The values allowed for ItemBackgroundProperties mirror those allowed within standard CSS definitions. The full scope of properties that are allowed (and their meanings) is beyond the scope of this document, but a complete description can be found at the W3C site here.

Support for specific ItemBackgroundProperties is highly browser dependent. Be sure to test your menus in a variety of browsers and platforms when using background image properties.

In order for ItemBackgroundProperties to be utilized, ItemBackgroundImage must be set. If ItemBackgroundImage is not set, then ItemBackgroundProperties will be ignored.

The scroll/fixed property of item background images will be ignored by HierMenus (even though it is set by default).

When using item background images, the item's background color will be covered by the image. Therefore, BGColorOver and BGColorSelected will not appear to function. They should still be set, however, for the benefit of those browsers for which HM does not support item background images or for users who specifically have image displays disabled in their browsers.

Examples:

// Ok:
ItemBackgroundProperties:"repeat-x",
ItemBackgroundProperties:"left repeat-y",
ItemBackgroundProperties:null,
ItemBackgroundProperties:(window.showBack)?"left":"right",
    // if the user defined variable "showBack" is true,
    // use "left" positioning, else "right"

// Incorrect:
ItemBackgroundProperties:repeat-x,   // Strings must be quoted
ItemBackgroundProperties:"null",     // null must NOT be quoted
ItemBackgroundProperties:"ZigZag",   // only valid CSS values allowed
ItemBackgroundProperties:'(window.showBack)?"left":"right"', 
    // no quoted expressions

Default:

"scroll top left repeat"

See Also:

MenuBackgroundImage, MenuBackgroundProperties, ScrollBackgroundImage, ItemBackgroundImage