The Point Style Item tag provides the ability to stylize each point that is rendered by the Point Theme. 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.
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. <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. <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> |
Three states: normal, selected and hover can be customized for each point by specifing images.
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>
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:
|
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 |