home / documentation / reference / positionchild

PositionChild

Description:

Indicates the position of a child menu in relationship to its parent item. Typically applied only to horizontal menu items.

Value:

default, above, below, or a JavaScript expression that returns one of these values.

Applies To:

Menu Items.

Browser Compatibility:

PositionChild is supported in all browsers.

Comments:

When set to above, the item's child menu is positioned immediately above the menu item. When below, the menu is positioned immediately below the menu item. When default, PositionChild has no effect on child menu positioning. You must enclose the keywords in quotes (see examples below).

PositionChild is applied to menu items, even though its resulting behavior is seen in the position of the child menu for the menu item (hence the parameter name PositionChild; i.e., "this is how you are to position my child menu").

PositionChild can be overridden by ChildKeepInWindowX, ChildKeepInWindowY, ChildMenuX, and ChildMenuY. PositionChild overrides ChildOffset, ChildPerCentOver, and ChildOverlap.

As indicated above, PositionChild is typically assigned only to horizontal menu items. Assigning a PositionChild setting to vertical menus usually results in an undesirable display, and is therefore not recommended.

PositionChild places the child menu so that its first menu item is aligned with the parent menu item. The horizontal alignment of the child menu when its width differs from that of the parent item (to the right or left edge of the parent item) depends on the RightToLeft setting of the parent menu item.

Examples:

// Ok:
PositionChild:"above",
PositionChild:"below",
PositionChild:"default",
PositionChild:(window.thisPage=="cf")?"above":null, 
    // if the user defined variable "thisPage" is "cf", 
    // PositionChild is "above"

// Incorrect:
PositionChild:above,  // above/below must be quoted
PositionChild:'(window.thisPage=="cf")?"above":null', 
    // no quoted expressions

Default:

true

See Also:

RightToLeft, ChildOffset, ChildOverlap, ChildPerCentOver, ChildMenuX, ChildMenuY, ChildKeepInWindowX, ChildKeepInWindowY, Menu Positioning Mini-Tutorial