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.
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
