IMF Developer's Guide

<tab>

IMF Developer's Guide » Site Configuration » <tabs> » <tab>

The <tab> element defines a tab for the tab bar above the map. There is a set of predefined tab graphics, but you can easily create new tabs and add them to your IMF application.

See also: tab image gallery and the examples listed at the bottom of the <tabs> element description.

Frequency	Parent Elements (the <tab> element is valid within):
PRS+	<tabs>

Frequency	Description (in this context)
PRS+	The <tab> element must appear one or more times within the <tabs> element after any decoration elements.

Attributes	Description
height	The height of the tool image, in pixels. Required.
help	The URL to a text file (some HTML permitted) that contains help for this tab to be included on the auto-generated help page. The URL can contain the special variable $IMF to specify that the document is relative to the IMF installation directory. Absolute URLs may also be used. URLs that don't start with http: or $IMF are resolved relative to the location of the XML file. Optional. Help text is generated from other attributes if this attribute is missing.
hint	A tool tip hint that appears if the user hovers the mouse over the tab. Optional.
graphic	The URL of the image for the tab. Required. The URL can contain the special variable $IMF to specify that the document is relative to the IMF installation directory. Absolute URLs may also be used. URLs that don't start with http: or $IMF are resolved relative to the location of the XML file.
name	The name of the tab for its description on the auto-generated help page. Required.
rollover-graphic	The URL of the rollover image for the tab. If defined, the rollover graphic will be displayed when the user moves the mouse over the tab. Optional. The URL can contain the special variable $IMF to specify that the document is relative to the IMF installation directory. Absolute URLs may also be used. URLs that don't start with http: or $IMF are resolved relative to the location of the XML file.
status	The message that will appear in the browser's status area when the user moves the mouse over the tab. Required for tools and buttons, ignored for spaces.
target	The name of the frame that the URL will be executed in. Use "_blank" to execute it in a new browser window. Required.
url	The URL that will be executed when the tab is clicked. Required.
width	The width of the tab image, in pixels. Required.

Example:

<tab name="Layers"
     url="$IMF/imfLayers.jsp"
     target="dataFrame"
     hint="Set Layers"
     help="$IMF/help/layersTab.txt"
     status="Set which layers display, and choose an identify layer."
     graphic="$IMF/tabs/bc/layers53x27.gif"
     width="53"
     height="27"/>