Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces 12c (12.1.3) E41655-01 |
UIComponent class: oracle.adf.view.faces.bi.component.thematicMap.UIArea
Component type: oracle.dss.adf.thematicMap.Area
An area is used to stamp out stylistic attributes such as colors and patterns onto the geographical areas of the map.
Label text and styles can be specified on the area tag, which will override the default region labels provided by the basemap. The value attribute is used to specify the text of the label, and the labelDisplay and lableStyle attributes can be used to customize the appearance of these labels. When labelDisplay="on" then the provided label value and labelStyle will override the label coming in from the areaLayer.
The Thematic Map supports formatting of the area labels specified in the value attribute. This can be done either by adding an <af:convertNumber> as a child of <dvt:area> or by specifying a converter via EL directly on the <dvt:area> 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:area id="a1" labelDisplay="on" value="#{mapBean.value}" converter="#{mapBean.myConverter}"/> <!--This uses the child convertNumber tag to convert the value--> <dvt:area id="a2" labelDisplay="on" value="#{mapBean.value}" > <af:convertNumber id="cn1" type="currency"/> </dvt:area>
If both a converter and a child af:convertNumber tag are specified, then the properties of the child tag take precedence.
An Area can be used as a drag source. To make an area a drag source, the application developer simply needs to add an <af:dragSource> as its child.
Example:
<dvt:area id="area" fillColor="#{tmapTargetActualBean.colorObj}" shortDesc="#{tmapTargetActualBean.tooltip}"> <af:dragSource actions="COPY" discriminant="DnDDemoModel"/> </dvt:area>
The <dvt:attributeGroups> tag can be used as a child of dvt:area. Instead of specifying fillColor, pattern, or opacity directly on the area tag, developers can use attributeGroups with type = "color", "pattern", or "opacity" to get these attributes automatically generated based on categorical bucketing of the data set. If any of these attributes are specified both in the area tag and within the attributeGroups type, then the style generated by the attributeGroups will take precedence.
The <dvt:area> tag can have the following children:
Type | Phases | Description |
---|---|---|
org.apache.myfaces.trinidad.event.AttributeChangeEvent | Invoke Application, Apply Request Values |
Event delivered to describe an attribute change. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change event might include the width of a column that supported client-side resizing. |
Name | Type | Supports EL? | Description |
---|---|---|---|
action | javax.el.MethodExpression | Yes | A reference to an action method sent by the component, or the static outcome of an action. |
actionListener | javax.faces.el.MethodBinding | Only EL | A method reference to an action listener |
attributeChangeListener | javax.el.MethodExpression | Only EL | A method reference to an attribute change listener |
binding | String | Only EL | Binding reference to store the UIArea component |
converter | javax.faces.convert.Converter | Yes | A converter object |
destination | String | Yes | The URI this component references |
fillColor | String | Yes | Default Value: #000000 Specifies the fill color of the areas of the map. Valid values are RGB hexadecimal. |
fillPattern | String | Yes | Specifies the built-in pattern used to fill the areas of the map. Valid values are:
|
id | String | No | the identifier for the component |
labelDisplay | String | Yes | Valid Values: on, off Default Value: off Determines how labels associated with this area should be displayed. Valid values are:
|
labelStyle | String | Yes | The font style for labels associated with this area. Accepts font-related CSS attributes like font-name, font-weight, font-size, color, etc. |
opacity | double | Yes | Specifies the opacity of the fill color of the areas of the map. Valid values are from 0.0 - 1.0, where 0.0 is transparent and 1.0 is opaque. |
rendered | boolean | Yes | Default Value: true Specifies whether the component is rendered. The default value is true. |
shortDesc | String | Yes | The short description of this component. This is used to customize the text that displays in the area's tooltip. |
value | String | Yes | The value of the component. When labelDisplay="on", this value will be used as the text label for this area stamp. The provided label value will override the label coming in from the areaLayer |