UIComponent class: oracle.adf.view.faces.bi.component.graph.UISparkChart
Component type: oracle.dss.trinidad.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.
Use the <dvt:referenceObject> tag to create either a reference line or a reference area. The reference object can be associated with any data axis or series. Multiple reference objects can be associated with a single series or an axis. Use the attribute "location" to specify whether the referenceObject should displayed in the front or the back of the data markers. Use graph's "referenceObjectDisplay" attributes to specify when the referenceObject would be displayed. Wrap all <dvt:referenceObject> tags in a <dvt:referenceObjectSet> tag.
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:
<referenceObjectSet>, <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 events might include the width of a column that supported client-side resizing. |
Name | Type | Supports EL? | Description |
---|---|---|---|
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 | String | Only EL |
Specifies a binding reference to store a specific instance of UISparkChart 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. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque. |
contentDelivery | String | Yes | Specifies whether to fetch content with page load or after page load. Valid values are lazy (default) and immediate. |
firstMarkerColor | String | Yes | Specifies the color of the first marker of the sparkchart. Enter values in RGB hexadecimal. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque. |
highMarkerColor | String | Yes | Specifies the color of the high value marker of the sparkchart. Enter values in RGB hexadecimal. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque. |
id | String | No | the identifier for the component. The identifier must follow a subset of the syntax allowed in HTML:
|
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. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque. |
lowMarkerColor | String | Yes | Specifies the color of the low value marker of the sparkchart. Enter values in RGB hexadecimal. This color property takes 6 or 8 digit hex as input. When 8 digit hex is used, the first 2 digits represent transparency, otherwise the color is opaque. |
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". The default value is "auto".
|
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 | 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 |
Specifies the type of spark chart. Valid values are:
|
tooltip | String | Yes | Specifies the tooltip text to display for this sparkchart. |