home / documentation / reference / ispermanent

IsPermanent

Description:

Boolean value indicating whether or not the menu should be treated as permanently visible.

Value:

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

Applies To:

Menus.

Browser Compatibility:

IsPermanent is supported in all browsers.

Comments:

Permanently visible menus are not hidden whenever all other menus are hidden; such as when a new menu tree is rolled over, or when the user clicks the mouse away from the menus in ClickKill pages.

As of HierMenus version 6, setting a menu to permanently visible does not, in and of itself, guarantee that the menu will be immediately displayed on page load. To ensure the menu is displayed on page load, you must be sure that its CreateOnLoad parameter is set to true.

Examples:

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

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

Default:

true

See Also:

CreateOnLoad, TopMenuX, TopMenuY, Menu Positioning Mini-Tutorial