|
home / documentation / reference / clickkill
ClickKill
- Description:
- Boolean value indicating whether or not menus should hide
when the mouse is clicked within the document.
- Value:
- Boolean (true or false), Integer (1=true, 0=false),
or JavaScript expression that returns a boolean value.
- Applies To:
- All Menus on a page.
- Browser Compatibility:
- ClickKill is supported in all browsers.
- Comments:
- When ClickKill is set to true, the menu will be
hidden only when the user clicks somewhere in the document away from
the menu itself. When false, the menu will be hidden after its designated
MilliSecondsVisible setting.
Note this unique behavior of ClickKill. When ClickKill is set
on any menu of a page, then all menus on the page (except
permanently displayed menus) will be hidden when the document is clicked. Those
menus on the page for which ClickKill is false will also be
hidden when their MilliSecondsVisible interval has elapsed.
When a menu tree of several cascaded menus is displayed, HierMenus honors the
ClickKill behavior of the last menu the user rolled over in
order to decide how and when to hide the entire menu tree. If the last menu the
user rolled over is set with ClickKill equal to true, then the
entire menu tree remains visible on the page until the user clicks somewhere
outside the menu tree. If the last menu the user rolls over is set with
ClickKill equal to false, then the menu tree is hidden based on the
MilliSecondsVisible setting of that last menu rolled over. This dual
hiding behavior can be confusing to users, and we therefore do not recommend it.
Permanently visible menus (IsPermanent is true), as their
name implies, are unaffected by ClickKill settings.
- Examples:
// Ok:
ClickKill:true,
ClickKill:0,
ClickKill:(window.thisPage=="cf")?1:0,
// if the user defined variable "thisPage" is "cf",
// ClickKill is true
// Incorrect:
ClickKill:"false", // quotes not allowed around booleans
ClickKill:"0",
ClickKill:'(window.thisPage=="cf")?1:0', // no quoted expressions- Default:
- false
- See Also:
-
ClickStart,
MilliSecondsVisible
|
