What's New Copy Link
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 version 34.3.
Documentation Copy Link
See AG Charts 11.0 Documentation.
Breaking Changes Copy Link
The full list of breaking changes across all features for version 11.0.
Breaking Changes
This release includes the following breaking changes:
AgCharts.setLicenseKey()- removed, useLicenseManager.setLicenseKey()instead.
Series Changes Copy Link
- Series type
bullet- removed, use the Linear Gauge instead. - Bar Series
label.placement:inside- removed, useinside-centerinstead.outside- removed, useoutside-endinstead.
- Waterfall Series
label.placement:inside- removed, useinside-centerinstead.start- removed, useoutside-startinstead.end- removed, useoutside-endinstead.
Axes Changes Copy Link
- All
AgCrossLineLabelPositionoptions are changed to kebab-case. For example,topLeftbecomestop-left. - If
axes[].tick.enabled: false, any providedaxis[].label.paddingis the distance between the label and the axis. - On all axis labels,
padding- removed, usespacinginstead. axes[].crosshair.label.className- removed, use the provided classes for adding custom styles or provide a custom HTML renderer instead.ag-crosshair-label*CSS classes - removed, useag-charts-crosshair-label*instead.- Removed redundant
formatof category axis labels:axes[type = 'category'].label.formataxes[type = 'category'].crosshair.label.formataxes[type = 'angle-category'].label.formataxes[type = 'radius-category'].label.format
Tooltip Changes Copy Link
- The tooltips have an improved visual layout and now include more information about the hovered item.
- The
tooltip.rendererhas changed:- It now takes
heading,titleanddataproperties instead oftitleandcontent. - The
headingandtitleproperties are typed asStringand thedataproperty is typed asString[]. These no longer accept HTML. - The
paramsprovided no longer returncolor. Usefillandstrokeinstead. - With the exception of
ohlc,candlestick, andwaterfallseries types,itemIdis no longer provided in theparams.
- It now takes
- The CSS classes have changed:
ag-chart-tooltip- removed, useag-charts-tooltipinstead.ag-chart-tooltip-title- removed, useag-charts-tooltip-headingandag-charts-tooltip-titleinstead.ag-chart-tooltip-content- removed, useag-charts-tooltip-labelandag-charts-tooltip-valueinstead.
tooltip.class- removed, use the provided classes for adding custom styles or provide a custom HTML renderer instead.
Financial Charts Changes Copy Link
chartTypeofrange-area- removed, usehlcinstead.AgPriceVolumePreset.rangeToolbar- removed, userangeButtonsinstead.AgPriceVolumePreset.xKey- removed, usedateKeyinstead.AgPriceVolumePreset.annotations- removed, usetoolbarinstead.
Miscellaneous Copy Link
legendItemClickandlegendItemDoubleClickevents no longer return the state of the clicked item in theparams. To get this information, subscribe to thechart.seriesVisibilityChangeevent.MarkerShapeunion is no longer typedany.- Custom marker shapes are now defined with a callback function instead of extending a
Markerclass. AgChartSerializableState- removed, useAgChartStateinstead.navigator.minandnavigator.max- removed, useinitialState.zoom.ratioX.startandinitialState.zoom.ratioX.endinstead.zoom.ratioX,zoom.ratioY- removed, useinitialState.zoom.ratioXandinitialState.zoom.ratioYinstead.zoom.rangeX,zoom.rangeY- removed, useinitialState.zoom.rangeXandinitialState.zoom.rangeYinstead.navigator.miniChart.label.padding- removed, usenavigator.miniChart.label.spacinginstead.- Locale string
toolbarAnnotationsColor- removed, usetoolbarAnnotationsLineColorinstead. - All icons with
-legacysuffix have been removed. toolbar.zoom- removed, usezoom.buttonsinstead. Unused options ofposition,align,size,draggable,buttons[].id, andbuttons[].roleare removed.toolbar.annotations- removed, useannotations.toolbarinstead. Unused options ofposition,align,size,draggable,buttons[].id, andbuttons[].roleare removed.toolbar.ranges- removed, usechart.rangesinstead. Unused options ofposition,align,size,draggable,buttons[].id, andbuttons[].roleare removed.toolbar.annotationsOptions- removed, useannotations.optionsToolbarinstead. Unused options ofposition,align,size,draggable,buttons[].id, andbuttons[].roleare removed.toolbar.seriesType- removed, usechart.chartToolbarinstead. Unused options ofposition,align,size,draggable, andbuttonsareag-chart-context-menu*CSS classes - removed, useag-charts-context-menu*instead.- Overlay CSS classes have changed:
ag-chart-loading-overlay- removed, useag-charts-loading-overlayinstead.ag-chart-no-data-overlay- removed, useag-charts-no-data-overlayinstead.ag-chart-no-visible-series- removed, useag-charts-o-visible-seriesinstead.
Behaviour Changes Copy Link
The full list of behaviour changes across all features for version 11.0.
Behaviour Changes
This release includes the following behaviour changes:
Theme Defaults Copy Link
- If
axes[].tick.enabled: true, the labels default to a padding of 5px away from the tick. - The Navigator - including its mask and handles - have updated height, fill and corner radius defaults.
Other Changes Copy Link
- All series and axis labels default to removing trailing zeros. Use the
formatandformatteroptions to modify.- Additionally some incorrect rounding scenarios have been fixed, e.g. 5.555 now correctly rounds to 5.56 instead of 5.55.
- Pie and Donut Series labels default to displaying two decimal places without trailing zeros. Use the
formatterorformatoptions 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.
- The default Zoom selection area when
axes: 'xy'now ignores aspect ratio. Usezoom.keepAspectRatioto change this. - Scrolling events on a chart with zoom enabled, will now be passed to the parent if zoom is at minimum or maximum levels.
- Disabling the legend at runtime will show all hidden series.
Deprecations Copy Link
There are no deprecations in AG Charts version 11.0
Changes List Copy Link
See the full list of changes in the AG Charts 11.0 changelog.