Summary

Tag name: <dvt:mapPointStyleItem>

The Point Style Item tag provides the ability to stylize each point in a <dvt:mapPointTheme>. As the Point Theme iterates through the set of points it has to render, it will try to find a matching Point Style. Generally, one or more Point Style Item tags would exist inside a Point Theme tag. Then either a data value or a text value of the point can be used to find a corresponding Point Style Item to render that point. See Point Styles for more details.

The normal (unselected), selected and hover states of a point can be changed by either specifying images or by changing the value of the built-in-image property.

The tag also provides the ability to change the default point style that can be used for all the points in the theme.

Important: The Point Style Item tags are ignored by the parent Point Theme tag if the customPointCallback attribute is specified on the theme tag.

Point Styles

Depending on the data type of the attribute in the model that is to be used for the point a few different options are available to have the Point Theme pick an appropriate Point Style Item tag to render the point.

Data Type Description & Example
Numeric Value

Use the minValue & maxValue attributes.

By using minValue & maxValue a range can be defined. In the example below, a house which is less than a million in value will be represented by the "< Million" Point Style Item tag and a house over a million will use the "> Million" Point Style Item tag. than a million dollor, it will be shown using the mansion icon.

          <dvt:mapPointTheme id="theme1" value="#{backingBean.geoMapModel}">
            <dvt:mapPointStyleItem shortLabel="< Million" minValue="0.0" maxValue="1000000.0"
               <!-- match on min & max value -->
               imageURL="/smallHouse.gif" hoverImageURL="/smallHouseHover.gif"
               selectedImageURL="/smallHouseSelected.gif" />
            <dvt:mapPointStyleItem shortLabel="> Million"
               minValue="1000000.0" <!-- match on min with no upper value value --> 
               imageURL="/bigHouse.gif"
               hoverImageURL="/bigHouseHover.gif"
               selectedImageURL="/bigHouseSelected.gif"/>
          </dvt:mapPointTheme>
Non-Numeric Value

Use the itemValue attribute.

An exact match can be performed via the itemValue property to allow the Point Theme to pick the appropriate Point Style Item. The category value from the data model is used to match with the itemValue attribute of the tag. In the example below, if the point data has "low" as the category value, the map uses the "< Million" Point Style Item to display the point. Otherwise, if the point category value is "high", the Point Theme will use the "> Million" Point Style Item tag.

          <dvt:mapPointTheme >
            <dvt:mapPointStyleItem shortLabel="< Million" 
               itemValue="low" <!-- exact match made with itemValue --> 
               imageURL="/smallHouse.gif"
               hoverImageURL="/smallHouseHover.gif"
               selectedImageURL="/smallHouseSelected.gif" />
            <dvt:mapPointStyleItem shortLabel="> Million" 
               itemValue="high" <!-- exact match made with itemValue -->
               imageURL="/bigHouse.gif" hoverImageURL="/bigHouseHover.gif"
               selectedImageURL="/bigHouseSelected.gif"/>
          </dvt:mapPointTheme>

Point States

Three states: normal, selected and hover can be customized for each point by specifing images.

  • imageURL -- An image representing the normal display state of the point
  • selectedImageURL -- An image for the selected state
  • hoverImageURL -- An image that is displayed when the mouse is over the image

Default Point Style

The Point Style Item also provides a simple way to change the rendering of all the points in the Point Theme.

       <dvt:mapPointTheme >
         <dvt:mapPointStyleItem attributes for style 1 using either min/max 
            or itemValue for matching.... />
         <dvt:mapPointStyleItem attributes for style 2 using either min/max 
            or itemValue for matching.... />
         <dvt:mapPointStyleItem isDefault="true" <-- Point Theme will
            use this when any of the above don't match--> other attributes
            can go here.../>
       </dvt:mapPointTheme>

Relationship with other tags

The <dvt:mapPointStyleItem> tag is a child of the <dvt:mapPointTheme> tag

Attributes

Name Type Supports EL? Description
id java.lang.String no Specifies the identifier for a point style item
isDefault boolean no Specifies whether this point style item overrides the default style. For example, to specify a different default image for all the points in the point theme, set this attribute to true, and use the desired imageURL in the imageURL attribute. The default value is false.
shortLabel java.lang.String no Specifies the label of this pointStyleItem on the legend if no itemValue is specified.
itemValue java.lang.String no Specifies the value associated with this point style. This attribute will used to match with the category of each GeoRowObject of the GeoModel of the pointTheme. Please use minValue and maxValue if the pointTheme's GeoModel does not have any category.
The itemValue has higher priority than minValue and maxValue. If the category of a GeoRow Object equals the itemValue of a pointStyle, the pointStyle will be used even if the value of the GeoRowObject lies outside the range of value of the point style.
minValue double no Specifies the lower bound value for this point style. Together with maxValue, this two attributes defines the range of value for this point style. ADF Map will check whether if the value of each GeoRowObject of the pointTheme's GeoModel lies within the range of value of each pointStyle.
The itemValue has higher priority than minValue and maxValue. If the category of a GeoRow Object equals the itemValue of a pointStyle, the pointStyle will be used even if the value of the GeoRowObject lies outside the range of value of the point style.
maxValue double no Specifies the upper bound value for this point style. Together with minValue, this two attributes defines the range of value for this point style. ADF Map will check whether if the value of each GeoRowObject of the pointTheme's GeoModel lies within the range of value of each pointStyle.
The itemValue has higher priority than minValue and maxValue. If the category of a GeoRow Object equals the itemValue of a pointStyle, the pointStyle will be used even if the value of the GeoRowObject lies outside the range of value of the point style.
imageURL java.lang.String no Specifies the imageURL for this pointStyleItem. If a GeoRowObject of the point theme matches this pointStyleItem, the point of the GeoRowObject will be displayed using the image in this imageURL.
selectedImageURL java.lang.String no Specifies the selectedImageURL for this pointStyleItem. If a GeoRowObject of the point theme matches this pointStyleItem, the image will be used as the selected Image for the point of the GeoRowObject. Hence, when the point is lied within the selected region that is defined by the user, the point will be displayed using the image defined in this attribute.
hoverImageURL java.lang.String no Specifies the selectedImageURL for this pointStyleItem. If a GeoRowObject of the point theme matches this pointStyleItem, the image will be used as the hover Image for the point of the GeoRowObject. Hence, when the user hovers over the point, the image in hoverImageURL will be shown.
builtInImage java.lang.String no

Specifies the builit in images for this point style item. Each built in image has a set of normal images, selected images and hovered images

Built in images are:

  • OrangePinLarge
  • OrangePinMedium
  • OrangePinSmall
  • OrangeBall
inlineStyle java.lang.String no Specifies the inlineStyle of the image of each point in the pointTheme. This attribute accepts any valid CSS style value. Usually, this attribute is used to set horiziontal and vertical offset for the images. (e.g. position:relative;top:20px)
styleClass java.lang.String no Set a CSS style class to use for the points in the pointTheme.
overlayText java.lang.String no
overlayStyle java.lang.String no
overlayClass java.lang.String no