Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces
12c (12.2.1)
E52773-01

<dvt:sparkChart>

dvt:sparkChart sparkChart spark chart

UIComponent class: oracle.adf.view.faces.bi.component.graph.RichSparkChart
Component type: oracle.dss.adf.graph.SparkChart

Overview

Use the <dvt:sparkChart> tag to create an ADF data visualization spark chart. Spark charts are simple, condensed graphs that display trends or variations, often in the column of a table. Sparkcharts are often displayed in a dashboard to provide additional context to a data-dense display. Here is a list of subtypes that a <dvt:sparkchart> tag supports -

area - Absolute area graph
bar - Vertical bar graph
floatingBar - Vertical floating stacked bar graph
line - Absolute line graph
lineWithArea - Line with area graph

Data Model

Use the <dvt:sparkItem> tag to specify data for the sparkChart. Each <dvt:sparkItem> tag represents a single bar or marker. The spark item's values are typically bound to an EL Expression, often pointing to a column in a row of a table. An af:iterator tag can also be used to stamp multiple spark items within a spark chart.

ReferenceObjects

Reference lines and reference areas can be added as direct children of the sparkChart. For example, to add a reference line, a dvt:referenceLine should be added as a child of dvt:sparkChart. Multiple reference objects can be associated with a single chart.

Thresholds

A Threshold represents a significant value range like quota, target or limit value etc. When a data value falls into one of the threshold ranges, it means certain criteria have been met or not. Different threshold ranges can have different colors, which you may customize.

Specify the threshold ranges by using <dvt:thresholdSet> tag and <dvt:threshold> tag. The thresholdMaxValue attribute is used to indicate the breakpoint of the ranges. For examples, if thresholdMaxValue of two threshold tags are specified, there will be three threshold ranges, starting from minimum value to first thresholdMaxValue, first thresholdMaxValue to second thresholdMaxValue and second thresholdMaxValue to maximum value.

Tooltips

Tooltips are useful to display identification and or detail information for the sparkchart. The tooltip can be specified using the "tooltip" attribute.

Relationship with other tags

The <dvt:sparkchart> tag can have the following child tags:

Geometry Management

This component will always be displayed in its default dimensions which are provided by the skin. This can be modified by applying a dimension using the inlineStyle or styleClass attributes.

Events

Type	Phases	Description
oracle.adf.view.faces.bi.event.ClickEvent	Apply Request Values	The ClickEvent is delivered when the component is clicked.
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
animationDuration	int	Yes	Default Value: 500 Specifies the animation duration in milliseconds. The default value is 500. For data change animations with multiple stages, this attribute defines the duration of each stage. For example, if an animation contains two stages, the total duration will be two times this attribute's value.
animationOnDataChange	String	Yes	Valid Values: none, auto Default Value: none Specifies the type of animation to apply on data change.
animationOnDisplay	String	Yes	Valid Values: none, auto, alphaFade Default Value: none Specifies the type of animation to apply when the component is initially displayed.
areaColor	String	Yes	Specifies the area color of the area and lineWithArea sparkcharts. Enter values in RGB hexadecimal.
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.
axisScaledFromBaseline	String	Yes	Valid Values: on, off Default Value: on Specifies whether the axis is scaled to include the baseline value of zero.
binding	oracle.adf.view.faces.bi.component.graph.RichSparkChart	Only EL	Specifies a binding reference to store a specific instance of RichSparkChart from a backing bean. Set this attribute only to access code in a backing bean. For example, to reference a spark chart component in the sampleGraph managed bean, use the following code: `binding="#{sampleGraph.sparkChart}"`
clickAction	String	Yes	Refers to a backing bean method that performs navigation processing for the graph and returns an outcome String. A static outcome String can also be specified. The JSF NavigationHandler selects the page to display next by matching the outcome String against the navigation rules in the application configuration resource file. The application writes the Navigation rules.
clickListener	String	Yes
color	String	Yes	Specifies the color of the bars, line, or area in the sparkchart. Enter values in RGB hexadecimal.
contentDelivery	String	Yes	Valid Values: whenAvailable, lazy, immediate Default Value: whenAvailable Specifies whether to fetch content with page load or after page load.
firstMarkerColor	String	Yes	Specifies the color of the first marker of the sparkchart. Enter values in RGB hexadecimal.
highMarkerColor	String	Yes	Specifies the color of the high value marker of the sparkchart. Enter values in RGB hexadecimal.
id	String	No	Specifies the identifier for the component
inlineStyle	String	Yes	Style of the outer element(enclosing div) of the component
lastMarkerColor	String	Yes	Specifies the color of the last marker of the sparkchart. Enter values in RGB hexadecimal.
lineStyle	String	Yes	Valid Values: solid, dotted, dashed Default Value: solid Specifies the line style of the line in the sparkchart. Only applies to line sparkcharts.
lineType	String	Yes	Valid Values: straight, curved, stepped, segmented, none Default Value: straight Specifies the line type of the line or area in the sparkchart. Only applies to line and area sparkcharts.
lineWidth	Number	Yes	Specifies the line width of the line or area in the sparkchart. Only applies to line sparkcharts.
lowMarkerColor	String	Yes	Specifies the color of the low value marker of the sparkchart. Enter values in RGB hexadecimal.
markers	String	Yes	Specifies the markers to display on a sparkchart. Valid values are combinations of the following constants, separated by spaces. For example, `markers="auto high last"`. `none` - does not display markers `auto` (default) - the graph decides whether to display markers and which markers to display `high` - displays a marker at the greatest value `low` - displays a marker at the smallest value `first` - displays a marker at the first value `last` - displays a marker at the last value
noDataErrorText	String	Yes	Specifies error text to display when graph has no data.
partialTriggers	String[]	Yes	the IDs of the components that should trigger a partial update. This component will listen on the trigger components. If one of the trigger components receives an event that will cause it to update in some way, this component will request to be updated too.
rendered	boolean	Yes	Default Value: true Specifies whether the component is rendered.
shortDesc	String	Yes	Specifies the short description of the graph. This is particularly useful in the screen reader mode.
styleClass	String	Yes	Sets a CSS style class to use for this component. Note that width and height should be set using the inlineStyle property.
subType	String	Yes	Valid Values: bar, floatingBar, line, area, lineWithArea Default Value: line Specifies the type of spark chart to display.
tooltip	String	Yes	This attribute is deprecated. Use the shortDesc attribute to specify tooltip text instead.