Target Frames

Target frames are mainly used when working with frame sets.

A frame set is a way of dividing a browser screen into various working areas, with separate web pages displayed in each frame. Each frame is usually given a name, the Target Frame name.

So, you could have a frame set of two frames, a small frame called "Contents" on the left, and a main frame called "Main".

By default, when the Display Page button in Hi HelpIndex is pressed, the selected page is displayed in the same frame, ie the Hi HelpIndex page is replaced by the chosen page. This is useful in most circumstances.

However, if you run Hi HelpIndex in the "Contents" frame then you will usually want to display pages in the "Main" frame. The best way to achieve this is to specify "Main" as the target parameter to Hi HelpIndex. You would normally set this parameter using our new web page wizard in the Index and Language Files page.


Setting Target Frame Names in Hi Lab

You can also set Target frame names in the Index file, ie for a Base URL, for a URL and for each Index Keyword.

If you set a Base URL target frame name, then this overrides the target parameter for each URL that uses this Base URL.
Similarly, if you set a target frame name for a URL, then this overrides both the target parameter and the Base URL target frame name.
Finally, if you give a target frame name for an Index keywords then this overrides all of the above.

If you specify a frame name that does not exist, then the browser usually opens new window with your given frame name.


Special Target Frame Names

You can use the following special target frame names. Note that each has an underscore as their first character.
_self The current frame
_parent The parent frame, when working in nested frame sets.
_top The top most frame, ie the complete window of the current browser
_blank Open a new browser window, with no name

Of these, the most common ones to use are _top and _blank.

For example, use _top for off-site links, where you want the new page to fill the whole browser window.


See also: Frames