The <theme> element is used to define multiple sites or views to be displayed on
the Themes page. If themes are used, the title, tools, layers, etc. will be changed
to an alternate set defined in a site configuration XML file when the theme is selected.
If the same-extent attribute is set to true, the new site will open at the same map
extent as when called. This is useful for displaying an alternate view or data set of
the same area.
| Frequency |
Parent Elements (this element is valid within): |
|
PR1+ |
<theme-config> |
| |
|
|
|
Attributes |
Description |
|
description |
The description of the theme. Required.
|
|
name |
The name of the theme. Required.
|
|
run-startup-scripts |
Specifies whether the startup scripts defined in the theme's site configuration file are
executed when the theme is activated. Valid values are "true" or "false". Defaults to "false".
(New at version 5.0.008.)
|
|
same-extent |
Specifies whether the map extent stays the same or if it reverts to the extent of the map service or site configuration XML when the map is reloaded. If same-extent="true", then the extent stays the same. Defaults to true.
|
|
site-config-xml |
The URL to the site configuration XML file that specifies how the theme is configured.
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. Required.
|
| |
|
|
| Frequency |
Description (in this context) |
|
PR1+ |
One or more themes must be defined within the theme-config element. |
| |
|
|
Example:
<?xml version="1.0" encoding="UTF-8"?>
<theme-config>
<theme name="Theme One" description="Description of theme one." site-config-xml="site-config-one.xml" same-extent="true"/>
<theme name="Theme Two" description="Description of theme two." site-config-xml="site-config-two.xml" same-extent="true"/>
</theme-config>
