7.9.0 adds highlightFilter and a Basque locale, and fixes animation and tooltip defects across most chart types. Four behaviours changed, listed below.
Behaviour changes
| Change | What you will see | To keep the old behaviour |
|---|---|---|
Unknown chart.type throws
| new ApexCharts() and updateOptions() throw and name the closest real type. They used to fail later, inside render().
| Fix the type name. '' and null now draw a line chart.
|
| Unknown options and bad axis bounds warn | A console.warn for a top-level key nothing reads, or an axis bound that cannot be parsed. Numeric strings such as yaxis.min: '10' now work.
| Correct or remove the option. |
| Box plots animate updates | Boxes morph from their previous shape on updateSeries().
| chart.animations.dynamicAnimation.enabled: false
|
| Needle gauge value label | Sits below the needle instead of under it. | Set plotOptions.radialBar.dataLabels.value.offsetY.
|
TypeScript: getState().seriesNames, getState().labels and a series' name are now typed string | number.
✨ New
highlightFilter(premium add-on,apexcharts/features/highlight-filter): draws each value faded and a part of it solid in front, from the same baseline. Works on bar, column, funnel, line, area, pie, donut, polarArea, radialBar and treemap.- Basque (
eu) locale, and the Galician toolbar labels completed (#5319). Thanks @jlancharro.
🐛 Fixes
- Legend toggles, updates and layout changes animate without jumps: hidden series flatten away, and the plot, pies and gauges ease to a new size.
- Treemap click-to-zoom and the breadcrumb animate as a camera move.
- Tooltips stay on the hovered mark on sparklines, heatmaps and horizontal bars, and keyboard focus places them where the pointer would.
- Canvas renderer: tooltips for box plots, candlesticks and markers, and hover that survives
updateSeries(). - An option set to
undefinedornullno longer crashes the chart, andupdateOptions({ xaxis })keeps category names. - Data labels stay visible during
updateSeries()(#5332), and the last label stays centred unless it would overflow. - Hiding a stacked area series with
[x, y]data flattens it onto the series below. - An explicit palette passed with
theme.modetoupdateOptions()is kept (#5041). Thanks @jamalkamaladdin. legend.showForNullSeriesworks with{ x, y }data (#5336). Thanks @jamalkamaladdin.- Y-axes mapped by
seriesNameno longer throw when there are fewer axes than series (#3836). Thanks @jamalkamaladdin. - CSV export sorts numeric and date rows by value. Thanks @NotAFlightRisk.
- 3D funnel shadows morph with their stages.
The default bundle is 298,123 B gzipped, 24.3 KB more than 7.8.0, from the animation and tooltip work.
Upgrading
npm install apexcharts@7.9.0
The detail behind each change is in the commits: v7.8.0...v7.9.0