Skip to main content

Radial Chart

Rocket 2.0

The Radial Chart component draws values as arcs around a center. Show one value as a progress ring or gauge, such as tasks completed against a target, or compare categories as concentric rings, such as visitors by channel.

Properties​

Property
Description
Expected Value
Modeprogress shows Value against Max value as a single ring; categories draws one ring per data row.progress, categories. Default: progress
ValueValue to show in progress mode.Number. Default: 72
Max valueValue that fills the ring completely. In categories mode, rings fill against this or the largest value, whichever is higher.Number. Default: 100
Data (categories mode)Rows to chart in categories mode, one ring per row. The first row is the outer ring.Array
Category fieldField in each row that names the ring, in categories mode.Text. Default: channel
Value fieldField in each row that sets the ring's length, in categories mode.Text. Default: visitors
Center figure (blank = the value)Large figure shown in the middle. Leave empty to show Value in progress mode.Text
Center captionCaption shown under the figure in the middle.Text. Default: Completed
Start angleAngle in degrees where the arc starts, counted counter-clockwise from 3 o'clock. 90 and -270 give a full ring from the top; 180 and 0 give a half-circle gauge.Number. Default: 90
End angleAngle in degrees where the arc ends. See Start angle.Number. Default: -270
Ring thickness (px, blank = auto)Width of each ring in pixels. Leave empty to size it to the chart.Text
Rounded endsRounds the ends of the arcs.On or off. Default: On
TrackShows a faint full-length track behind each arc.On or off. Default: On
Value prefixText shown before values, such as $.Text
Value suffixText shown after values. auto adds % in progress mode and nothing in categories mode.Text. Default: auto
Empty messageMessage shown when there is nothing to chart.Text. Default: No data
AnimateAnimates the arcs when the chart first draws or its data changes.On or off. Default: On
Legend (categories mode)Shows a legend that names each ring and its color, in categories mode.On or off. Default: On
Series colors (in order)Colors for the rings, used in order. Leave empty to use the theme's chart colors. A row's own color or fill field wins.Array
Highlight clicked pointKeeps the clicked ring highlighted and dims the others until another is clicked or Clear clicked point runs.On or off. Default: Off
Loading lookWhat shows while the chart is loading: a spinner or a skeleton block.Spinner, Skeleton. Default: Spinner

Additional Actions​

Each of these can be switched on or off, or set with a logical expression by clicking fx.

Property
Description
Expected Value
VisibilityShows or hides the component. Hidden components keep their space unless Collapse when hidden is on.On or off. Default: On
Collapse when hiddenRemoves the hidden component's space, so the components below it move up.On or off. Default: Off
Loading stateShows the component's loading look and blocks interaction, for example while a query runs.On or off. Default: Off
DisableStops the user from interacting with the component.On or off. Default: Off

Devices​

Property
Description
Expected Value
Show on desktopShows the component in the desktop layout.On or off. Default: On
Show on mobileShows the component in the mobile layout.On or off. Default: Off

Events​

Add a handler from the Events section of the properties panel. See Event Triggers for the steps.

Event
Description
On clickTriggers when the user clicks a ring.
On double clickTriggers when the user double-clicks the chart.

Component Specific Actions (CSA)​

Run these from an event handler with Control Component, or from a RunJS query. See Component Specific Actions.

Action
Description
How To Access
Clear clicked pointClears the clicked ring and its highlight.components.radialchart1.clearClickedPoint()
Set visibilityShows the component when true, hides it when false.components.radialchart1.setVisibility(false)
Set disableDisables the component when true, enables it when false.components.radialchart1.setDisable(false)
Set loadingTurns the loading state on with true, off with false.components.radialchart1.setLoading(false)

Exposed Variables​

Variable
Description
How To Access
modeprogress shows Value against Max value as a single ring; categories draws one ring per data row.{{components.radialchart1.mode}}
valueValue to show in progress mode.{{components.radialchart1.value}}
maxValueValue that fills the ring completely. In categories mode, rings fill against this or the largest value, whichever is higher.{{components.radialchart1.maxValue}}
dataRows to chart in categories mode, one ring per row. The first row is the outer ring.{{components.radialchart1.data}}
categoryFieldField in each row that names the ring, in categories mode.{{components.radialchart1.categoryField}}
valueFieldField in each row that sets the ring's length, in categories mode.{{components.radialchart1.valueField}}
centerValueLarge figure shown in the middle. Leave empty to show Value in progress mode.{{components.radialchart1.centerValue}}
centerLabelCaption shown under the figure in the middle.{{components.radialchart1.centerLabel}}
startAngleAngle in degrees where the arc starts, counted counter-clockwise from 3 o'clock. 90 and -270 give a full ring from the top; 180 and 0 give a half-circle gauge.{{components.radialchart1.startAngle}}
endAngleAngle in degrees where the arc ends. See Start angle.{{components.radialchart1.endAngle}}
thicknessWidth of each ring in pixels. Leave empty to size it to the chart.{{components.radialchart1.thickness}}
roundedRounds the ends of the arcs.{{components.radialchart1.rounded}}
showTrackShows a faint full-length track behind each arc.{{components.radialchart1.showTrack}}
valuePrefixText shown before values, such as $.{{components.radialchart1.valuePrefix}}
valueSuffixText shown after values. auto adds % in progress mode and nothing in categories mode.{{components.radialchart1.valueSuffix}}
emptyTextMessage shown when there is nothing to chart.{{components.radialchart1.emptyText}}
animateAnimates the arcs when the chart first draws or its data changes.{{components.radialchart1.animate}}
showLegendShows a legend that names each ring and its color, in categories mode.{{components.radialchart1.showLegend}}
colorsColors for the rings, used in order. Leave empty to use the theme's chart colors. A row's own color or fill field wins.{{components.radialchart1.colors}}
highlightClickedKeeps the clicked ring highlighted and dims the others until another is clicked or Clear clicked point runs.{{components.radialchart1.highlightClicked}}
loadingIndicatorWhat shows while the chart is loading: a spinner or a skeleton block.{{components.radialchart1.loadingIndicator}}
clickedDataPointThe data row of the ring the user clicked last. In progress mode it holds value and maxValue.{{components.radialchart1.clickedDataPoint}}
isVisibleWhether the component is visible.{{components.radialchart1.isVisible}}
isLoadingWhether the component is in its loading state.{{components.radialchart1.isLoading}}
isDisabledWhether the component is disabled.{{components.radialchart1.isDisabled}}

Styles​

Style
Default
Chart color (series palette from it)Theme: Brand primary
Track colorTheme: Surface 3
Legend text colorTheme: Placeholder text
Center figure colorTheme: Primary text
Center caption colorTheme: Placeholder text
Box shadow0px 0px 0px 0px #00000040

A default that starts with Theme: follows the app's theme until the style is set to another value. See App Themes.