home / documentation / reference / clickstart

ClickStart

Description:

Boolean value indicating whether or not menus should appear when their parent items or links are clicked.

Value:

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

Applies To:

Menus.

Browser Compatibility:

ClickStart is supported in all browsers.

Comments:

When ClickStart is set to true, the menu will be displayed only when the user clicks the menu's parent item or link. When false, the menu will appear when the parent item or link is rolled over.

Note that ClickStart is applied to the menu itself; not the parent menu item. In other words, it applies only to the menu it is set on, and not to child menus of this menu. (Unless it is set as a global parameter using HM_f_UpdateDefaults, in which case it applies, by default, to all menus.)

Note that normally, the HierMenus 6 design now allows you to reuse menus across multiple trees or links. However, a design flaw in the code prohibits this type of use in top level popup menus that are also set to ClickStart:true. For more detail on this issue as well as a workaround, see Known Issue #28.

Examples:

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

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

Default:

false

See Also:

ClickKill