home / documentation / reference / childkeepinwindowy

ChildKeepInWindowY

Description:

Boolean value indicating whether or not the menu should be automatically repositioned from its default location vertically so that the entire menu appears within the user's browser window. ChildKeepInWindowY applies only to menus that are displayed as child menus.

Value:

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

Applies To:

Menus.

Browser Compatibility:

ChildKeepInWindowY is supported in all browsers.

Comments:

Note that this parameter defines the menu's vertical KeepInWindow behavior when the menu is being displayed as a child menu. Compare this parameter to TopKeepInWindowY, which defines the menu's vertical KeepInWindow behavior when the menu is used as a top level menu. A single menu can be used as both a top level menu and a child menu on the same page. This Child vs. Top distinction allows you to define different settings depending on how the menu is currently being utilized.

All of the KeepInWindow behaviors are true by default; meaning that HierMenus will always attempt to reposition the menu both horizontally and vertically so that it appears within the user's browser window. In versions of HierMenus prior to version 6, permanently displayed menus and PositionChild child menus were not repositioned via the KeepInWindow behavior. If you wish to emulate the pre-version 6 behavior, you will need to set the appropriate KeepInWindow behaviors to false on those types of menus.

Examples:

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

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

Default:

true

See Also:

RepositionOnScroll, IsPermanent, PositionChild, TopKeepInWindowX, TopKeepInWindowY ChildKeepInWindowX