<dvt:marker>

dvt:marker marker marker

UIComponent class: oracle.adf.view.faces.bi.component.common.UIMarker
Component type: oracle.dss.adf.common.Marker

A marker is used to stamp out built-in shapes, custom shapes, or images associated with data. Markers can be customized with different stylistic attributes such as colors and patterns based on their underlying data.

Marker Shapes

Markers support a predefined set of shapes ("circle", "square", etc) that can be specified with the shape attribute on the marker tag. These built-in marker shapes can be styled by changing border and fill styles.

A custom shape can also be specified using the shapePath attribute which requires the path of an SVG image file. The SVG image will be drawn in place of a built-in marker shape and have the same selection effects as a built-in shape, but will use the colors and styles from the SVG image. Results look best when using simple SVG images with few or no gradients. The shape attribute will be ignored if shapePath is used.

Marker shapes can also be specified via skinning. With the skinning approach, predefined marker types can be overwritten, and the paths for custom marker shapes can also be defined without the shapePath attribute. In this case, the "shape" attribute in dvt:marker is used for defining built-in or custom shapes.

A predefined shape will be overwritten if a global or component-specific selector for that shape is specified:

       <dvt:marker id="m1" shape="circle"/>
       
       af|dvt-thematicMap::shape-circle{
         -tr-path: url(/resources/newCircle.svg);
       }
       

In order to specify a custom shape in the shape attribute, a "custom" prefix is required. For example if the shape is customFoo then the skin file should have a .AFDVTShapeCustomFoo:alias selector defined or the Thematic Map specific af|dvt-thematicMap::shape-customFoo defined which has the -tr-path property pointing to the svg file.

       <dvt:marker id="m1" shape="customFoo"/>
       
       af|dvt-thematicMap::shape-customFoo{
         -tr-path: url(/resources/newShape.svg);
       }
       

Marker Images

Markers can also support raster images by using the source attribute which requires the path of an image file. When marker is a child tag of a component that supports selection, use the sourceHover, sourceSelected, and sourceHoverSelected attributes to specify images to display for these selection states. The source attributes can also take SVG images, but rendering is platform depedent and will only display if the rendering platform supports that image format. For example, if rendering in Flash, SVG images will not display. When using the source attributes, the shape and shapePath attributes are ignored.

Label Customization

Label text and styles can be specified on the marker tag. The value attribute is used to specify the text of the label, and the labelDisplay, lableStyle, and labelPosition attributes can be used to customize the appearance and location of these labels. When labelDisplay="on" then the provided label value and labelStyle will be displayed at the given labelPosition relative to the marker. If a marker is displayed on a region (i.e. you have a marker within an areaDataLayer), and that marker has a label, then the label associated with the basemap region will NOT be shown.

Number Formatting

The Thematic Map supports formatting of the marker labels specified in the value attribute. This can be done either by adding an <af:convertNumber> as a child of <dvt:marker> or by specifying a converter via EL directly on the <dvt:marker> tag. If the value is numeric, then the properties of the given converter will be used to format the number appropriately. For example:

       <!--This uses a converter from the backing bean to convert the value-->
       <dvt:marker id="m1" labelDisplay="on" value="#{mapBean.value}" converter="#{mapBean.myConverter}"/>

       <!--This uses the child convertNumber tag to convert the value-->
       <dvt:marker id="m2" labelDisplay="on" value="#{mapBean.value}" >
         <af:convertNumber id="cn1" type="currency"/>
       </dvt:marker>
       

If both a converter and a child af:convertNumber tag are specified, then the properties of the child tag take precedence.

Drag and Drop

A marker can be used as a drag source. To make a marker a drag source, the application developer simply needs to add an <af:dragSource> as its child.
Example:

<dvt:marker fillColor="#{row.color}" scaleX="#{row.size/2}" 
               scaleY="#{row.size/2}" shape="circle" 
               id="m1">       
  <af:dragSource actions="COPY" discriminant="DnDDemoModel"/>             
</dvt:marker>  
       

Attribute Groups

The <dvt:attributeGroups> tag can be used as a child of dvt:marker. Instead of specifying fillColor, pattern, opacity, shape, scaleX, or scaleY directly on the marker tag, developers can use attributeGroups with type = "color", "pattern", "opacity", "shape", "scaleX", or "scaleY" to get these attributes automatically generated based on categorical bucketing of the data set. If any of these attributes are specified both in the marker tag and within the attributeGroups type, then the style generated by the attributeGroups will take precedence.

Relationship with other tags

The <dvt:marker> tag can have the following children:

• <dvt:attributeGroups>
• <af:convertNumber>

Events

Attributes