Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
12c (12.1.3)

E41655-01

<dvt:chartDataItem>

dvt:chartDataItem chartDataItem chart data item

UIComponent class: oracle.adf.view.faces.bi.component.chart.UIDataItem
Component type: oracle.dss.adf.chart.DataItem

Overview

Defines properties for a data item of an area, bar, bubble, combo, line, or scatter chart.

Supported Child Tags

Events

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.

Attributes

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.
attributeChangeListener javax.el.MethodExpression Only EL a method reference to an attribute change listener. 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 events might include the width of a column that supported client-side resizing.
binding oracle.adf.view.faces.bi.component.chart.UIDataItem Only EL

Specifies a binding reference to store a specific instance of UIDataItem from a backing bean. Set this attribute only to access code in a backing bean.

borderColor String Yes Specifies the border color for the data item.
color String Yes Specifies the color for the data item.
group Object Yes Specifies the group category for the data item.
id String No Specifies the identifier for the component
label String Yes Specifies the data label of the data item.
labelPosition String Yes Valid Values: auto, center, aboveMarker, belowMarker, beforeMarker, afterMarker, insideBarEdge, outsideBarEdge
Default Value: auto

Specifies the position of the data label. Valid values are:
  • auto - (default) The data label is centered on stacked bars and bubble charts, insideBarEdge for non-stacked bars, and after the marker on line, area and scatter charts.
  • center - Centered on the data point.
  • aboveMarker - above the data marker on line, area, scatter and bubble charts.
  • belowMarker - below the data marker on line, area, scatter and bubble charts.
  • beforeMarker - before the data marker on line, area, scatter and bubble charts. (To the left in non-bidi, right in bidi locale)
  • afterMarker - after the data marker on line, area, scatter and bubble charts. (To the right in non-bidi, left in bidi locale)
  • insideBarEdge - at the edge of the bar, inside.
  • outsideBarEdge - on top of bars with positive value, just below for bars with negative value.
The 'aboveMarker', 'belowMarker', 'beforeMarker', and 'afterMarker' values are ignored for bars, and position will fall back to 'auto' if set to those values. Similarly, 'insideBarEdge' and 'outsideBarEdge' are ignored for non-bar graph types. Bubble graphs calculate the optimal text size for the centered data labels. If centered and the label is too long to fit on the data point, the label is automatically dropped for bar and truncated for bubble.
labelStyle String Yes Specifies the font style for the labels. Accepts font-related CSS attributes like font-name, font-weight, font-size, color, etc.
markerDisplayed boolean Yes Default Value: false

Specifies whether the data item markers are displayed. Only applies to line or area series types.
markerShape String Yes Valid Values: auto, square, circle, diamond, plus, triangleDown, triangleUp, human
Default Value: auto

Returns the shape of the data item marker. Default value is "auto".
markerSize Number Yes Returns of size of the data item marker, if one is displayed. Does not apply to bars in a bar chart. In a bubble chart, the proportional size of data item's marker is determined by the z attribute value.
pattern String Yes Valid Values: auto, smallChecker, smallCrosshatch, smallDiagonalLeft, smallDiagonalRight, smallDiamond, smallTriangle, largeChecker, largeCrosshatch, largeDiagonalLeft, largeDiagonalRight, largeDiamond, largeTriangle
Default Value: auto

Specifies the built-in pattern used to fill the node. Default value is "auto". The pattern is drawn with a white background, and the foreground color is taken from the color attribute.
rendered boolean Yes Default Value: true

Specifies whether the component is rendered. The default value is true.
series Object Yes Specifies the series category for the data item.
shortDesc String Yes Specifies the description for the data item. This is used for accessibility and also for customizing the tooltip text. If this value is not specified, the default tooltip text will be used for accessibility.
value Number Yes Specifies the value of the data item.
x Object Yes Specifies the x value of the data item.
y Number Yes Specifies the y value of the data item.
z Number Yes Specifies the z value of the data item. Only applies to bubble charts, where this value determines the proportional size of the data item.