What's New
See the release post for feature highlights of what's new in this major version.
Users of integrated charting on AG Grid, should refer to this migration guide when upgrading to AG Grid 33.
Breaking Changes
This release includes the following breaking changes:
Compatibility
The minimum version of Angular you can use with AG Charts is now Angular 17.
Series Changes
- Series type
bullet
is removed. Use the Linear Gauge instead. - Bar Series
label.placement
:inside
is renamed toinside-center
.outside
is renamed tooutside-end
.
- Waterfall Series
label.placement
:inside
is renamed toinside-center
.start
is renamed tooutside-start
.end
is renamed tooutside-end
.
Axes Changes
- All
AgCrossLineLabelPosition
options are changed to kebab-case. For example,topLeft
becomestop-left
. - If
axes[].tick.enabled: false
, any providedaxis[].label.padding
is the distance between the label and the axis.
Financial Charts Changes
chartType
ofrange-area
is renamed tohlc
.AgPriceVolumePreset.rangeToolbar
is renamed torangeButtons
.AgPriceVolumePreset.xKey
is renamed todateKey
.AgPriceVolumePreset.annotations
is renamed totoolbar
.
Miscellaneous
- Locale string
toolbarAnnotationsColor
is renamed totoolbarAnnotationsLineColor
. - All icons with
-legacy
suffix have been removed. - The
any
type is removed from theMarkerShape
union. - Custom marker shapes are now defined with a callback function instead of extending a
Marker
class. AgChartSerializableState
is removed. UseAgChartState
instead.navigator.min
andnavigator.max
are removed. UseinitialState.zoom.ratioX.start
andinitialState.zoom.ratioX.end
instead.zoom.ratioX
,zoom.ratioY
are removed. UseinitialState.zoom.ratioX
andinitialState.zoom.ratioY
instead.zoom.rangeX
,zoom.rangeY
are removed. UseinitialState.zoom.rangeX
andinitialState.zoom.rangeY
instead.
Behaviour Changes
This release includes the following behaviour changes:
Theme Defaults
- If
axes[].tick.enabled: true
, the labels default to padding of 5px away from the tick.
Other Changes
- All series and axis labels default to removing trailing zeros. Use the
format
andformatter
options to modify. - Pie and Donut Series labels default to displaying two decimal places without trailing zeros. Use the
formatter
functions to modify. - A stacked normalized area series datum where all the values are 0 will connect to a point at 0 rather than leaving a gap.
- Scrolling events on a chart with zoom enabled, will now be passed to the parent if zoom is at minimum or maximum levels.
Changes List
If you would like to see the full list of changes in this release, please see the Changelog.