Skip to main content
Version: Next

Scatter Chart

Scatter and bubble plots, with optional size and grouping fields. The right tool when you are looking for a relationship between two variables rather than a trend over time.

The Scatter Chart component as it renders with its default settings.The Scatter Chart component as it renders with its default settings.

Reach for it when you need:

  • Temperature against yield
  • Speed against reject rate, grouped by product

Component name: ScatterChart · Category: Chart

In the palette: Scatter / bubble (size + group fields). Bind data to a named query; click a point to expose {{point.value}} ([x, y]).

Properties

Any property can be bound to a tag, another component's property, or a query.

PropertyTypeDefaultDescription
dataarray[{"x":12,"y":18,"size":14,"group":"Line A"},{"x":15,"y":22,"… (truncated)Array of row objects. Bind to a named query ({{query.MyQuery}}), a tag, or edit inline. Rows map to series via categoryField + seriesFields (auto-derived when empty).
animationbooleantrueEnable enter/update animation.
animationDurationnumber600ms.
animationEasingenumcubicOutOptions: linear · cubicIn · cubicOut · cubicInOut · quadraticOut · elasticOut · bounceOut.
animationDelaynumber0Per-datum stagger (ms).
titleobject{"show":true,"text":"","subtext":"","left":"left"}
legendobject{"show":true,"type":"plain","orient":"horizontal","left":"ce… (truncated)
tooltipobject{"show":true,"trigger":"axis","axisPointerType":"line"}
colorPalettestring""Comma-separated series colors (e.g. #2563eb, #16a34a). Empty ⇒ theme palette.
backgroundColorcolor""Empty ⇒ transparent/theme.
xAxisobject{"show":true,"name":"","type":"category","min":"","max":"","… (truncated)
yAxisobject{"show":true,"name":"","type":"value","min":"","max":"","spl… (truncated)
gridobject{"left":8,"right":16,"containLabel":true}
dataZoomobject{"enabled":false,"type":"inside","start":0,"end":100}
xFieldstring""COLUMN NAME for the X value. Empty ⇒ first numeric column.
yFieldstring""COLUMN NAME for the Y value. Empty ⇒ second numeric column.
sizeFieldstringsizeBubble size: COLUMN NAME whose value sizes each bubble (a field like 'size', not a number). Empty ⇒ all points the same size.
groupFieldstringgroupSeries split: COLUMN NAME to split points into colored series/legend groups (e.g. 'grp'). Empty ⇒ one series.
symbolenumcircleOptions: circle · rect · roundRect · triangle · diamond · pin · arrow · none.
symbolSizenumber24Point diameter in px. With a sizeField set, this is the LARGEST bubble; values scale up to it. Raise it for bigger bubbles.
enableClickbooleantrueFire the Data click event + expose lastClicked.
lastClickedobject{}Output (bind from this): the last-clicked datum — {{ ThisChart.lastClicked.value }}.
optionOverridestring""Power user: paste a raw JSON object of chart options to deep-merge over the built chart, e.g. {"series":[{"itemStyle":{"color":"#e11"}}]}. Empty = none.
emptyMessagestringNo data
stylestyle{}Custom CSS properties

Events

Attach event actions to these in the Event Manager.

EventLabelGroupPayload
clickClickMouseThe DOM event.
dblclickDouble clickMouseThe DOM event.
contextmenuRight clickMouseThe DOM event.
mouseenterMouse enterMouseThe DOM event.
mouseleaveMouse leaveMouseThe DOM event.
dataClickData clickChartThe clicked datum, under point.
dataDblClickData double clickChartThe clicked datum, under point.
legendSelectLegend toggleChartThe toggled series.
Right-click behaves differently in the Designer

contextmenu fires your configured actions at runtime only — in LiveView and in preview. On the Designer canvas the right-click is captured to open the Event Manager, so testing it there will not run your actions. Test right-click in preview.