Skip to main content

Overview

The options property contains chart type-specific settings. Different options are available depending on which chart type you’re using.

Line chart options

Smooth lines

isSmoothLine
boolean
default:"false"
Whether to use smooth (curved) lines for line charts. When true, lines are drawn with curves. When false, lines are straight between data points.

Line thickness

lineThickness
number | 'auto'
default:"auto"
Line thickness in pixels. Set to 'auto' to automatically determine the appropriate thickness based on chart size, or provide a specific pixel value.

Show points

showPoints
boolean
default:"false"
Whether to show data point markers on the line. Useful for emphasising individual data points or when you have sparse data.

Missing values

missingValues
'gap' | 'connect' | 'zero'
default:"gap"
How to handle missing values (nulls) in line charts: - 'gap' - Break the line where values are missing - 'connect'
  • Connect the line across missing values - 'zero' - Treat missing values as zero

Bar and column chart options

Sort bars

sortBars
boolean
default:"false"
Whether to sort bars in descending order by value. Only applies to categorical bar and column charts with a single series.

Scatter plot options

Point size

pointSize
number | 'auto'
default:"auto"
Custom point size for scatter plots in pixels. Set to 'auto' to automatically determine the appropriate size, or provide a specific pixel value.

Combo chart options

Combo type

comboType
'grouped-bars' | 'stacked-bars' | 'lines'
default:"grouped-bars"
Determines the type of combo plot to show: - 'grouped-bars' - Display series as grouped bars alongside each other - 'stacked-bars' - Stack series bars on top of each other - 'lines' - Display series as lines

Pie and donut chart options

Pie total position

pieTotalPosition
'center' | 'outside'
default:"outside"
Where to show the sum of all values in a pie or donut chart: - 'center' - Show the total in the center of the chart (particularly useful for donut charts) - 'outside' - Show the total outside the chart area

Combining options

You can combine multiple options for the same chart type:
Options that don’t apply to your current chart type are ignored. For example, setting isSmoothLine on a bar chart has no effect.