cfmapitem
Description
The cfmapitem tag is a child tag of the cfmap tag. This tag creates markers on the map. You can specify the marker in a map using either the cfmapitem tag or using the ColdFusion.Map.AddMapMarker JavaScript API. See ColdFusion.Map.addMarker for details.
Categories
Related
History
ColdFusion
9: Added this tag.
Syntax
<cfmapitem
address="address"
latitude="latitude in degrees"
longitude="longitude in degrees"
markercolor="marker color"
markericon="icon path "
markerwindowcontent="content"
name="name of the map"
showmarkerwinodw=""true|false"
tip="marker tip" />
Attributes
| Attribute | Description | Required | Default |
|---|---|---|---|
| address | The address of the location to set the map marker. | Required, if latitude and longitude are not specified | |
| latitude | The latitude value for the marker, in degrees. | Required, if address is not specified | |
| longitude | The longitude value for the marker, in degrees. | Required, if address is not specified | |
| markercolor | Indicates the color of the marker. Specify a string value, for example "black", "red", or "green". By default, the centermarker is green in color. The attributes markericon and markercolor are mutually exclusive. | Optional | green |
| markericon | Location of an image file to use as the marker icon. The attributes markericon and markercolor are mutually exclusive. | Optional | |
| markerwindowcontent | Static content displayed in the marker window. This attribute ignores the markerbind attribute defined in the tag cfmap. | Optional | |
| name | The name of the map. | Optional | |
| showmarkerwindow | If set to true, displays the marker window. If the attribute markerbind is used, unless you set this attribute to true, the marker window is not displayed. | Optional | Inherits parent cfmap setting |
| tip | A short description of the marker location that appears as a tool tip. | Optional |
Usage
This tag must be used within the cfmap tag.
The following inheritance rules apply:
The value specified for the attribute showmarkerwindow in the cfmap tag is inherited by all cfmapitem tags.
A child cfmapitem tag can override the attribute showmarkerwindow in the cfmap tag by changing the value.
Any bind expression defined using the markerbind is ignored if the cfmapitem tag defines the attribute markerwindowcontent.
The following inheritance rules apply:
The value specified for the attribute showmarkerwindow in the cfmap tag is inherited by all cfmapitem tags.
A child cfmapitem tag can override the attribute showmarkerwindow in the cfmap tag by changing the value.
Any bind expression defined using the markerbind is ignored if the cfmapitem tag defines the attribute markerwindowcontent.