Hiermenus Go Forth, VI - DHTML Lab | 6 | WebReference

Hiermenus Go Forth, VI - DHTML Lab | 6

Logo

Hiermenus Go Forth, VI:
Version 4 - The Page-Specific Parameters (cont'd)



HM_PG_ClickStart

Description
Sets the top-level-menu display event to link "click" (if true) and "mouseover" (if false) for all menu trees in the page.

Menu displays with click:

Menu displays with mouseover:



HM_PG_ClickStart overrides site-wide global settings declared in the external script.

HM_PG_ClickStart can be overruled on a per-tree basis by the top_is_permanent parameter element in top-level menu arrays, which causes the top-level menu to be permanently visible and its display is not instigated by any user action.

Value
Boolean.
May be specified as:
  • true Boolean (true / false)
  • integer Boolean (1 / 0)
  • string
  • string JS expression to be evaluated

Example Values
true Boolean: true
    Top-level menus are displayed when the user clicks a link in the page.

true Boolean: false
    Top-level menus are displayed when the user mouses over a link in the page.

integer Boolean: 1
    Top-level menus are displayed when the user clicks a link in the page.

integer Boolean: 0
    Top-level menus are displayed when the user mouses over a link in the page.

string: "true"
    Top-level menus are displayed when the user clicks a link in the page.

string: "false"
    Top-level menus are displayed when the user mouses over a link in the page.

JS expression: "getClickStart()"
    A custom function that you have created will be called. The return value of this function will be the HM_PG_ClickStart parameter, and all menu trees in the page will comply.

JS expression: "(isMac) ? false : true)"
    The complete JS code is included in the parameter declaration. In the above example, HM_PG_ClickStart will be false if a Macintosh is being used and true for all other platforms.

Default
If this parameter is omitted, the relevant Global Parameter value set in the external script is used.

Differences from Version 3 equivalent
The clickStart parameter in Version 3:
  • was mandatory.
  • did not accept JS expression values.

Comments
HM_PG_ClickStart sets the user event dynamically. Do not set the link event to onClick. Links should always have an onMouseOver event. In this way, we minimize HTML page code interventions.

Next, HM_PG_ClickKill.


Produced by Peter Belesis and

All Rights Reserved. Legal Notices.
Created: Dec 12, 2000
Revised: Dec 12, 2000

URL: http://www.webreference.com/dhtml/column42/3.html