BaseChart
Defined in: core/base.ts:49
Shared lifecycle, layout, theming, accessibility, and event plumbing for
every SwiftChart chart class. End users typically don’t construct
BaseChart directly — they instantiate one of the concrete subclasses
(LineChart, BarChart, PieChart, …) — but BaseChart is the type
surfaced from chartRef.current.chart and from the imperative API, so
the public methods documented here apply to every chart.
Public surface used by consumers:
- setData — replace the chart’s data
- update — patch config or data without recreating the chart
- setTheme — switch palette by registered name
- resize — force a re-layout
- toDataURL — export as PNG (or other canvas-supported format)
- destroy — tear down listeners, observers, tooltip, canvas
Internals worth knowing about (protected):
_rebakeColorsForTheme()— re-resolvescolorFieldcolours when the theme changes. Pie/Funnel/Treemap override it to redo their bake.
BaseChartConfig for the cross-chart config shape.
Extended by
Section titled “Extended by”BarChartLineChartPieChartScatterChartRadarChartGaugeChartHBarChartSparklineStackedAreaChartWaterfallChartTreemapChartStackedBarChartBubbleChartHeatmapChartCandlestickChartBoxplotChartFunnelChartSankeyChartComboChartRadialBarChartBulletChartMarimekkoChartNetworkChart
Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new BaseChart(
container,config?):BaseChart
Defined in: core/base.ts:122
Parameters
Section titled “Parameters”container
Section titled “container”string | HTMLElement
config?
Section titled “config?”BaseChartConfig = {}
Returns
Section titled “Returns”BaseChart
Properties
Section titled “Properties”animator
Section titled “animator”animator:
Animator
Defined in: core/base.ts:63
animProgress
Section titled “animProgress”animProgress:
number=1
Defined in: core/base.ts:74
canvas
Section titled “canvas”canvas:
HTMLCanvasElement
Defined in: core/base.ts:60
config
Section titled “config”config:
Required<Pick<BaseChartConfig,"title"|"animate"|"animDuration"|"animEasing"|"responsive"|"showGrid"|"showTooltip"|"showLegend"|"legendPosition"|"subtitle">> &BaseChartConfig
Defined in: core/base.ts:52
container
Section titled “container”container:
HTMLElement
Defined in: core/base.ts:51
Host element the canvas was mounted into.
ctx:
CanvasRenderingContext2D
Defined in: core/base.ts:61
height
Section titled “height”height:
number=0
Defined in: core/base.ts:89
hoverIndex
Section titled “hoverIndex”hoverIndex:
number=-1
Defined in: core/base.ts:65
hoverSeriesIndex
Section titled “hoverSeriesIndex”hoverSeriesIndex:
number=-1
Defined in: core/base.ts:73
Index of the series under the cursor, or -1 when the hover is not
series-specific (e.g. a column hit on a multi-series line chart).
Charts that can pinpoint a series — bubble, scatter, network, sankey,
marimekko, treemap — set this in their _onMouse. Single-series charts
report 0 automatically via _buildClickEvent.
padding
Section titled “padding”padding:
Padding
Defined in: core/base.ts:90
resolved
Section titled “resolved”resolved:
ResolvedData
Defined in: core/base.ts:75
theme:
Theme
Defined in: core/base.ts:62
tooltip
Section titled “tooltip”tooltip:
Tooltip|null
Defined in: core/base.ts:64
width:
number=0
Defined in: core/base.ts:88
Accessors
Section titled “Accessors”plotArea
Section titled “plotArea”Get Signature
Section titled “Get Signature”get plotArea():
PlotArea
Defined in: core/base.ts:328
Returns
Section titled “Returns”Methods
Section titled “Methods”_draw()
Section titled “_draw()”
abstract_draw():void
Defined in: core/base.ts:951
Returns
Section titled “Returns”void
_onMouse()
Section titled “_onMouse()”
abstract_onMouse(e):void
Defined in: core/base.ts:950
Parameters
Section titled “Parameters”MouseEvent
Returns
Section titled “Returns”void
destroy()
Section titled “destroy()”destroy():
void
Defined in: core/base.ts:461
Returns
Section titled “Returns”void
resize()
Section titled “resize()”resize():
void
Defined in: core/base.ts:432
Returns
Section titled “Returns”void
setData()
Section titled “setData()”setData(
data,mapping?):void
Defined in: core/base.ts:350
Parameters
Section titled “Parameters”Record<string, any>[] | null | undefined
mapping?
Section titled “mapping?”Returns
Section titled “Returns”void
setTheme()
Section titled “setTheme()”setTheme(
theme):void
Defined in: core/base.ts:389
Switch theme. Accepts a registered theme name ('midnight', 'arctic',
'ember', 'forest', or any name passed to addTheme) or a
full Theme object — same surface that the constructor accepts
via config.theme.
Parameters
Section titled “Parameters”Returns
Section titled “Returns”void
toDataURL()
Section titled “toDataURL()”toDataURL(
type?,quality?,options?):string
Defined in: core/base.ts:446
Export the current chart as a data URL.
canvas.toDataURL() always returns the backing-store bitmap, which
is DPR-multiplied — a 400×300 chart on a DPR=2 display exports as
800×600. Pass { scale: 'css' } to downscale the export to on-screen
CSS dimensions (typical for “Save as PNG” buttons); the default
'native' keeps the full backing-store resolution.
Parameters
Section titled “Parameters”string = 'image/png'
quality?
Section titled “quality?”number = 0.92
options?
Section titled “options?”scale?
Section titled “scale?”"native" | "css"
Returns
Section titled “Returns”string
update()
Section titled “update()”update(
arg,mapping?):void
Defined in: core/base.ts:401
Polymorphic update:
- update(dataArray, mapping?) — replaces data (alias of setData).
- update(configPatch) — patches non-data config (theme, title, padding, etc.).
Parameters
Section titled “Parameters”Record<string, any>[] | Partial<BaseChartConfig>
mapping?
Section titled “mapping?”Returns
Section titled “Returns”void