home / documentation / reference / isrollover

IsRollover

Description:

Boolean value indicating whether or not a menu item should respond to mouse rollovers.

Value:

Boolean (true or false), Integer (1=true, 0=false), or JavaScript expression that returns a boolean value.

Applies To:

Menu Items.

Browser Compatibility:

IsRollover is supported in all browsers.

Comments:

For some menu items, such as items that are meant to be labels or added solely for decorative effects, you may wish to cancel HierMenus' standard rollover behavior. You can do so by setting IsRollover to false for the item.

When IsRollover is set to false, several behaviors are automatically cancelled when the user rolls over a menu item:

• "More" image rollover graphics are not swapped
• Embedded image rollover graphics are not swapped
• Background/foreground colors are not changed; neither the standard nor the selected color set will be applied
• Over and/or selected class names (if they were supplied) are not applied

Or, in short, when the mouse rolls over the menu item no visible change is applied to that item. The item itself can still be clicked, however, launching a new page and/or spawning a child menu.

Examples:

// Ok:
IsRollover:true,
IsRollover:0,
IsRollover:(window.thisPage=="cf")?1:0, 
    // if the user defined variable "thisPage" is "cf", 
    // IsRollover is true

// Incorrect:
IsRollover:"false",  // quotes not allowed around booleans
IsRollover:"0",
IsRollover:'(window.thisPage=="cf")?1:0', // no quoted expressions

Default:

true

See Also:

IsPermHilite, KeepHilite, IsSelected