radialBar
Configuration Structure
radialBar: {}size
Deprecated. This property is no longer available.
inverseOrder
falseWhether to make the first value of series innermost or outermost
startAngle
0Angle from which the radialBars should start
endAngle
360Angle to which the radialBars should end. The sum of the startAngle and endAngle should not exceed 360.
offsetX
Sets the left offset for radialBars
offsetY
Sets the top offset for radialBars
shape
Available since v5.12.0. Sub-shape used when rendering a gauge (chart.type: 'gauge'). Both shapes honor bands and ticks independently.
Available Options:
- arc (default) — fills a colored value-arc proportional to the series value, mirroring the classic radialBar look.
- needle — replaces the value-arc with a rotating pointer/needle. Use together with
needleandpivotto style the indicator.
min
Gauge value-to-angle mapping (lower bound). Defaults to 0. Override together with max to use a custom domain (e.g. min: 0, max: 240 for a speedometer).
max
Gauge value-to-angle mapping (upper bound). Defaults to 100.
bands
Threshold bands rendered as colored arc segments along the gauge arc. Each band spans [from, to] in the gauge's min..max domain and is filled with color. Useful for showing healthy / warning / critical zones.
plotOptions: {
radialBar: {
bands: [
{ from: 0, to: 50, color: '#00E396', label: 'Healthy' },
{ from: 50, to: 80, color: '#FEB019', label: 'Warning' },
{ from: 80, to: 100, color: '#FF4560', label: 'Critical' }
]
}
}
bandsStyle
Styling applied to all bands.
strokeWidth
Width of the band arc. Accepts a percentage string (e.g. '97%') relative to the gauge radius.
gap
Gap in pixels between adjacent bands.
hideTrackWhenPresent
When true, the background track is hidden if at least one band is defined. The bands then act as the visual track.
linecap
How the ends of each band arc are drawn. Available options: butt, round, square.
ticks
Tick marks rendered along the gauge arc. Independent of bands and works for both arc and needle shapes.
show
Show or hide all tick marks.
major
Major (large) tick marks. Typically used to highlight round numbers in the gauge domain.
count
Number of major tick marks to render across the arc.
length
Length of each major tick mark in pixels.
width
Stroke width of each major tick mark.
color
Color of major tick marks.
placement
Where to draw the major tick marks relative to the gauge arc. Available options: inside, outside.
minor
Minor (small) tick marks rendered between major ticks.
count
Number of minor tick marks between each pair of major ticks.
length
Length of each minor tick mark in pixels.
width
Stroke width of each minor tick mark.
color
Color of minor tick marks.
placement
Where to draw the minor tick marks relative to the gauge arc. Available options: inside, outside.
labels
Numeric labels rendered alongside major ticks.
show
Show or hide tick labels.
offset
Distance between each label and its tick mark.
fontSize
Font-size for tick labels.
fontFamily
Font-family for tick labels.
fontWeight
Font-weight for tick labels.
color
Color for tick labels.
formatter
A custom formatter that receives the tick's domain value and returns the string to display.
ticks: {
labels: {
formatter: function (value) {
return value + ' km/h'
}
}
}
needle
Styling for the gauge needle. Only used when shape: 'needle'.
color
Fill color of the needle.
baseRadius
Radius of the needle's base (the wide end attached to the pivot), in pixels.
length
Length of the needle. Accepts a number (pixels) or a percentage string relative to the gauge radius (e.g. '85%').
baseWidth
Width of the needle at its base.
tipWidth
Width of the needle at its tip. Set lower than baseWidth for a tapered pointer.
animation
Controls the sweep animation when the gauge value changes.
enabled
Enable or disable needle animation.
duration
Animation duration in milliseconds.
easing
Easing function name applied to the needle sweep (e.g. '<>' for ease-in-out, '-' for linear).
pivot
Styling for the center pivot disk that the needle rotates around. Only relevant for shape: 'needle'.
show
Show or hide the pivot disk.
color
Fill color of the pivot disk.
strokeColor
Border color of the pivot disk.
strokeWidth
Border width of the pivot disk.
margin
Spacing which will be subtracted from the available hollow size
size
Size in percentage relative to the total available size of chart
background
Background color for the hollow part of the radialBars
image
Optional image URL which can be displayed in the hollow area.
imageWidth
Width of the hollow image
imageHeight
Height of the hollow image
imageOffsetX
Sets the left offset of hollow image
imageOffsetY
Sets the top offset of hollow image
imageClipped
If true, the image doesn't exceeds the hollow area and is contained within.
position
Available Options
- front
- back
dropShadow
enabled
Enable a dropshadow for paths of the SVG
top
Set top offset for shadow
left
Set left offset for shadow
blur
Set blur distance for shadow
opacity
Set the opacity of shadow.
color
Color of the dropshadow
track
show
Show track under the bar lines.
startAngle
Angle from which the track should start.
endAngle
Angle to which the track should end.
background
Color of the track. If you want different color for each track, you can pass an array of colors.
strokeWidth
Width of the track
opacity
Opacity of the track
margin
Spacing between each track
dropShadow
enabled
Enable a dropshadow for the track
top
Set top offset for track shadow
left
Set left offset for track shadow
blur
Set blur distance for track shadow
opacity
Opacity of the track shadow
color
Color of the track dropshadow
dataLabels
show
Whether to display labels inside radialBars or not
name
show
Show the name of the respective bar associated with it's value
fontSize
FontSize of the name in dataLabel
fontFamily
FontFamily of the name in dataLabel
fontWeight
Font-weight of the name in dataLabel
color
Color of the name in dataLabel
offsetY
Sets the top offset for name
value
show
Show the value label associated with the name label
fontSize
FontSize of the value label in dataLabel
fontFamily
fontFamily of the value label in dataLabel
fontWeight
Font weight of the value label in dataLabel
color
Color of the value label in dataLabel
offsetY
Sets the top offset for value label
formatter
A custom formatter function to apply on the value label in dataLabel
total
show
Show the total of all the series in the inner area of radialBar
label
Label for "total". Defaults to "Total"
color
Color of the total label
fontSize
Font-size of the total label in dataLabel
fontFamily
font-family of the total label in dataLabel
fontWeight
font-weight of the total label in dataLabel
formatter
A custom formatter function to apply on the total value. It accepts one parameter w which contains the chart's config and global objects.
Defaults to a total of all series percentage divided by the length of series.
barLabels
enabled
When using custom angles in a radial bar chart, you can use this option. Here's a demo using this option
offsetX
Left offset of the labels
offsetY
Top offset of the labels
useSeriesColors
Whether to use primary colors or not.
fontSize
Sets the font-size of legend text elements
fontFamily
Sets the font-family of legend text elements
fontWeight
Sets the font-weight of legend text elements
formatter
A custom formatter function to modify the label text
onClick
Fire an event when the label is clicked