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

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

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

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

'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

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

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

'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

'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.