home / documentation / reference / childupondisplay

ChildUponDisplay

Description:

JavaScript code to be executed each time the menu is displayed as a child menu.

Value:

null, or String JavaScript expression.

Applies To:

Menus.

Browser Compatibility:

ChildUponDisplay is supported in all browsers.

Comments:

This parameter defines JavaScript code that should be executed when the menu is being displayed as a child menu. Compare this parameter to TopUponDisplay, which defines JavaScript code that should be executed when the menu is being displayed 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 JavaScript code depending on how the menu is currently being utilized.

When using a String JavaScript expression (i.e., a JavaScript expression contained within quotes), that expression will not be evaluated until just before the menu is displayed. It will then be reevaluated every time the menu is redisplayed.

Examples:

// Ok:
ChildUponDisplay:null,       // cancel inherited UponDisplay
ChildUponDisplay:"HM_f_ToggleElementList(false,['select'],'tag')", 
    // hide all select elements

// Incorrect:
ChildUponDisplay:"null",     // no quotes around null
ChildUponDisplay:HM_f_ToggleElementList(false,['select'],'tag'),
    // must have quotes around String JavaScript Expressions

Default:

null

See Also:

TopUponDisplay, TopUponHide, ChildUponHide, Bulletin 6: Hiding Page Elements, Bulletin 12: Synchronizing Link Rollovers