Hiermenus Go Forth, VI:
Version 4 - The Page-Specific Parameters (cont'd)
[Editor's note: this page was updated on May 1, 2003 to add support
for later browsers.]
HM_PG_UponHide
Description
Specifies a JavaScript statement to be evaluated when a menu tree is hidden. All menu trees in the page are affected.
The menu below has a SELECT form element immediately below it. When the menu appears, the form element is hidden. Otherwise, the element could show through the menu. See DHTML Diner for a discussion on form element persistence.
A custom function that you have created will be called. Unlike function calls used to determine other parameter values, here we expect no return value. We simply execute the function statements when a menu appears.
JS expression: "document.bgColor='white'"
The background color of the page is changed back to "white" when any menu tree is hidden.
Default
If this parameter is omitted, the relevant Global Parameter value set in the external script is used.
Differences from Version 3 equivalent
There is no Version 3 equivalent. Authors were expected to insert their own code if they needed additional statements executed when a menu tree was hidden.
Comments
This parameter should be used in conjunction with HM_PG_UponDisplay, discussed on the previous page.
This concludes our discussion of the Page-Specific Parameters. We are now ready to publish the external script in our next column.