home / documentation / reference / itemopacity

ItemOpacity

Description:

The opacity level to apply to a menu item.

Value:

null, or a number ranging from 0 (completely transparent) to 1 (completely opaque).

Applies To:

Menu Items.

Browser Compatibility:

ItemOpacity is supported in Internet Explorer 5.5+, Netscape 6.1+, Mozilla 1.0+, and Safari 1.1+.

Comments:

You must always specify ItemOpacity as a number between 0 and 1 (inclusive), or a JavaScript expression that returns a number in that range. Do not use quoted strings or non-numerical characters when defining ItemOpacity. ItemOpacity is always interpreted by HM as a percentage; i.e., .8 = 80% opaque.

Special care must be taken when assigning opacity via this parameter (ItemOpacity) and to the menu itself via an Internet Explorer filter. See the reference entry for IEFilters for details.

Setting both ItemOpacity and MenuOpacity on the same menu is not recommended. Some browsers (especially Internet Explorer 5.5) can have trouble rectifying the combined opacity effect, resulting in some menu elements not being displayed properly (if at all).

null is the only non-numeric value allowed for ItemOpacity. When set to null, the ItemOpacity setting is ignored by HierMenus.

Examples:

// Ok:
ItemOpacity:.2,   // 20% opaque
ItemOpacity:.85,  // 85% opaque
ItemOpacity:null, // ignore opacity setting
ItemOpacity:(window.HM_IE55)?null:.7,
   // ignore setting in IE5.5+; 70% otherwise

// Incorrect:
ItemOpacity:".4",
ItemOpacity:10%,
ItemOpacity:.5%,
ItemOpacity:"(window.HM_IE55)?null:.7",
   // do not quote expressions here

Default:

null

See Also:

MenuOpacity, IEFilters