Hi Jump

Page Contents	Overview  Set up  Parameters  Twice on a Page  Example  Deployment  Possible Improvements

Hi Jump provides a user with links to a 'home' page, and 'previous', 'next' and 'up' in the contents, as defined by a Hi HelpIndex index file. In addition, standard links may be provided, eg for email feedback or any other web pages.

When a user's mouse is poised over a link, the name of the page title is displayed in a "tip".

Links are shown as grayed out if they are not available, eg if there is no Next page in the index.

Hi Jump made be included twice on a page easily.

We understand that Microsoft Frontpage provides similar style navigation arrows. However Frontpage requires you to use a Microsoft server and will not work on a CD-ROM.
Hi Jump is browser independent and will work from CD-ROM.

<APPLET code=Jump archive="hijump10.zip" width=252 height=45>
<PARAM NAME=cabbase VALUE="hijump10.cab">
... other parameters ...
<APPLET>

It is easy to set up the font and colours used by the title tips using the Font, FgColor and tipBgColor parameters.

Set the index parameter to the name of the Hi HelpIndex index file used to describe the order of the pages.

Next, set the me parameter to the file name of the page, eg intro.html. Do not include any directories. (Note that this is only strictly necessary for users who are running Internet Explorer 3. If they run IE4, N3 or N4 then the me parameter is not needed and so is not used.)

Note carefully that the index and Icons parameters are all URLs relative to the applet code base.

Now set up the linkN and Images parameters carefully. Hint: look at the source for this page; copy the proud.gif and sunken.gif images.

Link Parameters

Usually you will have the first four links as Home, Up, Previous and Next, so simply set the first four link parameters as follows:

<PARAM NAME=link1 VALUE="h">
<PARAM NAME=link2 VALUE="p">
<PARAM NAME=link3 VALUE="l">
<PARAM NAME=link4 VALUE="r">


URL type	'h' Home 'p' Parent (Up in contents) 'l' Left (Previous in contents) 'r' Right (Next in contents) 'd' Jump to the URL, relative to the applet document base. 'c' Jump to the URL, relative to the applet code base. 'b' Jump to the URL, relative to the index's first base url.
URL	The URL to jump to.
Title	The title displayed in the tip. NB Can have "\n" to force a line feed in the tip.
Target	The target frame.

For example, to have a fixed email, glossary and company web site links, you could use:

<PARAM NAME=link5 VALUE="d,mailto:support:yourco.com,Support">
<PARAM NAME=link6 VALUE="c,glossary.html,Glossary">
<PARAM NAME=link7 VALUE="d,http://www.yourco.com/,Company Site,_top">


You must give the names of two images in the Icons parameter. The first 'proud' image has all the icons of the links in unpressed state, while the second 'sunken' image has all the icons of the links in pressed state,

Both the 'proud' and 'sunken' images are made up of equal sized icons for each of the links, arranged across the image. There must be an icon for each of the linkN parameters. The overall applet width must match the width of the images.

Hint 1: the 'sunken' icons must give the impression that a button has been pressed. Put 2 pixel wide black bars on the left and top sides of the icon, and 2 pixel wide grey bars on the right and bottom sides of the icon. The 'sunken' icon should be centred within these black and grey button sides, so displace the 'proud' icon left and up 2 pixels.

Hint 2: Give the icon images a blank space at the bottom. The title tips will then appear in this space and so will not obscure the button when they are pressed.

Here are links to the 'proud' and 'sunken' images for Hi Jump running on this page:

	'proud'
	'sunken'

For example, to make the tip foreground colour blue, add

<PARAM NAME=fgcolour VALUE="blue">

You can make one instance of Hi Jump the main one. This instance reads the index file. Other instances of Hi Jump are marked as being a 'slave'; they pick up all the parameters and index file settings from the main instance of Hi Jump.

Slave instances of Hi Jump simply need two parameters, Slave and Me, eg:

<PARAM NAME=slave VALUE="True">
<PARAM NAME=me VALUE="index.html">

<APPLET code=Jump archive="hijump10.zip" width=252 height=45 alt="Hi Jump navigation">
<PARAM NAME=cabbase VALUE="hijump10.cab">

<PARAM NAME=index VALUE="jump.hi">
<PARAM NAME=me VALUE="index.html">

<PARAM NAME=icons VALUE="proud.gif,sunken.gif">

<PARAM NAME=link1 VALUE="h">
<PARAM NAME=link2 VALUE="p">
<PARAM NAME=link3 VALUE="l">
<PARAM NAME=link4 VALUE="r">

<PARAM NAME=link5 VALUE=",mailto:support@phdcc.com,Support\nQuestions">
<PARAM NAME=link6 VALUE="b,glossary.html,Glossary,_top">
<PARAM NAME=link7 VALUE="d,http://www.phdcc.com/helpindex/,PHD Computer Consultants Ltd,_top">

<PARAM NAME=tipbgcolor VALUE="orange">
<PARAM NAME=bgcolor VALUE="white">
<PARAM NAME=fgcolor VALUE="blue">
<PARAM NAME=font VALUE="TimesRoman 8">

<!--If not Java-enabled, just provide a link to the home page-->

<A HREF="/"><IMG SRC="home.gif" ALT="Home page"></A>

</APPLET>

<APPLET code=Jump archive="hijump10.zip" width=252 height=45 alt="Hi Jump">
<PARAM NAME=cabbase VALUE="hijump10.cab">

<PARAM NAME=slave VALUE="True">
<PARAM NAME=me VALUE="index.html">
</APPLET>

In the code base directory, put:

• hijump10.zip
• hijump10.cab
• Jump.class
• JumpBaseURL.class
• JumpIndexFile.class
• JumpLink.class
• JumpUrlInfo.class
• PHDStringTokenizer.class
• PHDUtils.class
• <your index file>
• <your image files>, eg proud.gif and sunken.gif

Note that Hi Lab does not include these files for you automatically.

A signed jar file, hijump10.jar, is available should you prefer to use it; use APPLET ARCHIVE="hijump10.jar" instead.

• Only one image needed, with sunken image generated automatically.
  No... as it would ruin blank space at bottom of icons
• Force me parameter to override the actual page name.
  This would be useful when the actual page is part of a frame set.