apex:scatterSeries

A data series to be rendered as individual (not connected) points in a linear Visualforce chart. At a minimum you must specify the fields in the data collection to use as X and Y values for each point, as well as the X and Y axes to scale against.

Note: This component must be enclosed within an <apex:chart> component. You can have multiple <apex:scatterSeries> components in a single chart. You can also add <apex:areaSeries>, <apex:barSeries>, and <apex:lineSeries> components, but the results might not be very readable.

Example

<!-- Page: -->
<apex:chart height="530" width="700" animate="true" data="{!data}">
    <apex:scatterSeries xField="data1" yField="data2" 
        markerType="circle" markerSize="3"/>
    <apex:axis type="Numeric" position="bottom" fields="data1" 
        title="Torque" grid="true">
        <apex:chartLabel/>
    </apex:axis>
    <apex:axis type="Numeric" position="left" fields="data2" 
        title="Lateral Motion" grid="true">
        <apex:chartLabel/>
    </apex:axis>
</apex:chart>

Attributes

Attribute Name Attribute Type Description Required? API Version Access
axis String
Which axis this chart series should bind to. Must be one of the four edges of the chart:
  • left
  • right
  • top
  • bottom
The axis bound to must be defined by a sibling <apex:axis> component.
26.0
highlight Boolean A Boolean value that specifies whether each point should be highlighted when the mouse pointer passes over it. If not specified, this value defaults to true. 26.0
id String An identifier that allows the chart component to be referenced by other components on the page. 26.0 global
markerFill String The color of data point markers for this series, specified as an HTML-style (hexadecimal) color. 26.0
markerSize Integer The size of each data point marker for this series. 26.0
markerType String
The shape of each data point marker for this series. Valid options are:
  • circle
  • cross
If not specified, the marker shape is chosen from a sequence of shapes.
26.0
rendered Boolean A Boolean value that specifies whether the chart series is rendered in the chart. If not specified, this value defaults to true. 26.0
rendererFn String A string that specifies the name of a JavaScript function that augments or overrides how each data point is rendered. Implement to provide additional styling or to augment data. 26.0
showInLegend Boolean A Boolean value that specifies whether this chart series should be added to the chart legend. If not specified, this value defaults to true. 26.0
tips Boolean A Boolean value that specifies whether to display a tooltip for each data point marker when the mouse pointer passes over it. The format of the tip is <xField>: <yField>. If not specified, this value defaults to true. 26.0
title String The title of this chart series, which is displayed in the chart legend. 26.0
xField String The field in each record provided in the chart data from which to retrieve the x-axis value for each data point in the series. This field must exist in every record in the chart data. Yes 26.0
yField String The field in each record provided in the chart data from which to retrieve the y-axis value for each data point in the series. This field must exist in every record in the chart data. Yes 26.0