Skip to content

Documentation / @ripl/charts / CartesianChartOptions

Interface: CartesianChartOptions<TData> ​

Defined in: charts/src/core/cartesian.ts:219

Options shared by all cartesian charts.

Extends ​

Extended by ​

Type Parameters ​

Type ParameterDefault type
TDataunknown

Properties ​

PropertyTypeDescriptionInherited fromDefined in
animation?boolean | Partial<ChartAnimationOptions>Animation configuration, or a boolean toggling all transitions. See ChartAnimationOptions.BaseChartOptions.animationcharts/src/core/chart.ts:128
annotations?ChartAnnotation[]Reference lines, shaded bands, and point markers drawn over the plot. See ChartAnnotation.-charts/src/core/cartesian.ts:231
autoRender?booleanWhether the chart renders automatically on construction and after every Chart.update. Defaults to true.BaseChartOptions.autoRendercharts/src/core/chart.ts:122
axis?ChartAxisInput<TData>X/y axis configuration, or a boolean toggling both axes. See ChartAxisInput.-charts/src/core/cartesian.ts:221
crosshair?ChartCrosshairInputCrosshair configuration, or a boolean toggle. See ChartCrosshairInput.-charts/src/core/cartesian.ts:229
description?stringAccessible description announced by screen readers (sets the rendering element's ARIA label). Defaults to the title text.BaseChartOptions.descriptioncharts/src/core/chart.ts:132
grid?ChartGridInputBackground grid configuration, or a boolean toggle. See ChartGridInput.-charts/src/core/cartesian.ts:223
legend?ChartLegendInputLegend configuration, a position string, or a boolean toggle. See ChartLegendInput.-charts/src/core/cartesian.ts:227
navigator?boolean | NavigatorInteractionsEnables pan/zoom (and optionally brush) navigation on the plot. true turns on wheel-zoom and click-drag pan; an object configures each interaction individually. The chart auto-creates a DOMNavigator on its context and rescales the axis domains as the view changes, with no data rebuild. Access the underlying controller via chart.navigator for imperative framing (centerOn/fitBounds) or brush-and-link.-charts/src/core/cartesian.ts:239
overview?boolean | ChartOverviewOptionsEnables an overview "scrub bar" strip beside the plot with a draggable window that selects the visible range of the category axis (a bottom bar for category-on-x charts, a side bar for a horizontal bar chart). true uses the default size; an object sets it. Enabling the strip also turns on in-plot wheel/drag pan-zoom (category-axis only) unless navigator is explicitly false. Only category-axis charts (line, area, bar, trend) render the strip.-charts/src/core/cartesian.ts:247
padding?PaddingInputSpace reserved around the chart, in pixels. A single number applies to all four edges; a [top, right, bottom, left] tuple or a partial { top, right, bottom, left } object sets individual edges, leaving unspecified edges at the default. Defaults to 16.BaseChartOptions.paddingcharts/src/core/chart.ts:124
theme?string | ThemeTheme for this chart: a registered name ('light'/'dark'/'auto'), or a Theme. Falls back to the module default (see setDefaultTheme).BaseChartOptions.themecharts/src/core/chart.ts:130
title?string | Partial<ChartTitleOptions>Chart title as plain text, or a ChartTitleOptions object for full control.BaseChartOptions.titlecharts/src/core/chart.ts:126
tooltip?ChartTooltipInputHover-tooltip configuration, or a boolean toggle. See ChartTooltipInput.-charts/src/core/cartesian.ts:225