Oracle Fusion Middleware Data Visualization Tools Tag Reference for Oracle ADF Faces 12c (12.2.1.3) E80087-01 |
dvt:sparkChart sparkChart spark chart
UIComponent class: oracle.adf.view.faces.bi.component.graph.RichSparkChart
Component type: oracle.dss.adf.graph.SparkChart
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 -
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.
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.
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 are useful to display identification and or detail information for the sparkchart. The tooltip can be specified using the "tooltip" attribute.
The <dvt:sparkchart> tag can have the following child tags:
<referenceArea>, <referenceLine>, <sparkItem>, <thresholdSet>
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. |
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: |
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,
|
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. |