radialBar

Configuration Structure

radialBar: {
inverseOrder: boolean,
startAngle: number,
endAngle: number,
offsetX: number,
offsetY: number,
hollow: { ... },
margin: number,
size: string,
background: string,
image: string,
imageWidth: number,
imageHeight: number,
imageOffsetX: number,
imageOffsetY: number,
imageClipped: boolean,
position: 'front' | 'back',
dropShadow: ApexDropShadow,
enabled: boolean,
top: number,
left: number,
blur: number,
opacity: number,
color: string,
track: { ... },
show: boolean,
startAngle: number,
endAngle: number,
background: string | string[],
strokeWidth: string,
opacity: number,
margin: number,
dropShadow: ApexDropShadow,
enabled: boolean,
top: number,
left: number,
blur: number,
opacity: number,
color: string,
dataLabels: { ... },
show: boolean,
name: { ... },
show: boolean,
fontFamily: string,
fontWeight: string | number,
fontSize: string,
color: string,
offsetY: number,
value: { ... },
show: boolean,
fontFamily: string,
fontSize: string,
fontWeight: string | number,
color: string,
offsetY: number,
formatter: Function,
total: { ... },
show: boolean,
label: string,
color: string,
fontFamily: string,
fontWeight: string | number,
fontSize: string,
formatter: Function,
barLabels: { ... },
enabled: boolean,
offsetX: number,
offsetY: number,
useSeriesColors: boolean,
fontFamily: string,
fontWeight: string | number,
fontSize: string,
formatter: Function,
onClick: Function,
}

size

radialBar.hollow.size

Deprecated. This property is no longer available.

inverseOrder

Default: false

Whether to make the first value of series innermost or outermost

startAngle

Default: 0

Angle from which the radialBars should start

endAngle

Default: 360

Angle 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 needle and pivot to 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

radialBar.hollow.margin

Spacing which will be subtracted from the available hollow size

size

radialBar.hollow.size

Size in percentage relative to the total available size of chart

background

radialBar.hollow.background

Background color for the hollow part of the radialBars

image

radialBar.hollow.image

Optional image URL which can be displayed in the hollow area.

imageWidth

radialBar.hollow.imageWidth

Width of the hollow image

imageHeight

radialBar.hollow.imageHeight

Height of the hollow image

imageOffsetX

radialBar.hollow.imageOffsetX

Sets the left offset of hollow image

imageOffsetY

radialBar.hollow.imageOffsetY

Sets the top offset of hollow image

imageClipped

radialBar.hollow.imageClipped

If true, the image doesn't exceeds the hollow area and is contained within.

position

radialBar.hollow.position

Available Options

  • front
  • back

dropShadow

radialBar.hollow.dropShadow

enabled

radialBar.hollow.dropShadow.enabled

Enable a dropshadow for paths of the SVG

top

radialBar.hollow.dropShadow.top

Set top offset for shadow

left

radialBar.hollow.dropShadow.left

Set left offset for shadow

blur

radialBar.hollow.dropShadow.blur

Set blur distance for shadow

opacity

radialBar.hollow.dropShadow.opacity

Set the opacity of shadow.

color

radialBar.hollow.dropShadow.color

Color of the dropshadow

track

show

radialBar.track.show

Show track under the bar lines.

startAngle

radialBar.track.startAngle

Angle from which the track should start.

endAngle

radialBar.track.endAngle

Angle to which the track should end.

background

radialBar.track.background

Color of the track. If you want different color for each track, you can pass an array of colors.

strokeWidth

radialBar.track.strokeWidth

Width of the track

opacity

radialBar.track.opacity

Opacity of the track

margin

radialBar.track.margin

Spacing between each track

dropShadow

radialBar.track.dropShadow

enabled

radialBar.track.dropShadow.enabled

Enable a dropshadow for the track

top

radialBar.track.dropShadow.top

Set top offset for track shadow

left

radialBar.track.dropShadow.left

Set left offset for track shadow

blur

radialBar.track.dropShadow.blur

Set blur distance for track shadow

opacity

radialBar.track.dropShadow.opacity

Opacity of the track shadow

color

radialBar.track.dropShadow.color

Color of the track dropshadow

dataLabels

show

radialBar.dataLabels.show

Whether to display labels inside radialBars or not

name

radialBar.dataLabels.name

show

radialBar.dataLabels.name.show

Show the name of the respective bar associated with it's value

fontSize

radialBar.dataLabels.name.fontSize

FontSize of the name in dataLabel

fontFamily

radialBar.dataLabels.name.fontFamily

FontFamily of the name in dataLabel

fontWeight

radialBar.dataLabels.name.fontWeight

Font-weight of the name in dataLabel

color

radialBar.dataLabels.name.color

Color of the name in dataLabel

offsetY

radialBar.dataLabels.name.offsetY

Sets the top offset for name

value

radialBar.dataLabels.value

show

radialBar.dataLabels.value.show

Show the value label associated with the name label

fontSize

radialBar.dataLabels.value.fontSize

FontSize of the value label in dataLabel

fontFamily

radialBar.dataLabels.value.fontFamily

fontFamily of the value label in dataLabel

fontWeight

radialBar.dataLabels.value.fontWeight

Font weight of the value label in dataLabel

color

radialBar.dataLabels.value.color

Color of the value label in dataLabel

offsetY

radialBar.dataLabels.value.offsetY

Sets the top offset for value label

formatter

radialBar.dataLabels.value.formatter

A custom formatter function to apply on the value label in dataLabel

total

radialBar.dataLabels.total

show

radialBar.dataLabels.total.show

Show the total of all the series in the inner area of radialBar

label

radialBar.dataLabels.total.label

Label for "total". Defaults to "Total"

color

radialBar.dataLabels.total.color

Color of the total label

fontSize

radialBar.dataLabels.total.fontSize

Font-size of the total label in dataLabel

fontFamily

radialBar.dataLabels.total.fontFamily

font-family of the total label in dataLabel

fontWeight

radialBar.dataLabels.total.fontWeight

font-weight of the total label in dataLabel

formatter

radialBar.dataLabels.total.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

radialBar.barLabels.enabled

When using custom angles in a radial bar chart, you can use this option. Here's a demo using this option

offsetX

radialBar.barLabels.offsetX

Left offset of the labels

offsetY

radialBar.barLabels.offsetY

Top offset of the labels

useSeriesColors

radialBar.barLabels.useSeriesColors

Whether to use primary colors or not.

fontSize

radialBar.barLabels.fontSize

Sets the font-size of legend text elements

fontFamily

radialBar.barLabels.fontFamily

Sets the font-family of legend text elements

fontWeight

radialBar.barLabels.fontWeight

Sets the font-weight of legend text elements

formatter

radialBar.barLabels.formatter

A custom formatter function to modify the label text

onClick

radialBar.barLabels.onClick

Fire an event when the label is clicked