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 version 34.3.
Documentation
See AG Charts 12.0 Documentation .
Breaking Changes The full list of breaking changes across all features for version 12.0.
Breaking Changes This release includes the following breaking changes:
Series Changes series[].type is now required. Axes Changes time axis properties of unit, paddingInner, paddingOuter, groupPaddingInner are removed. Use the unit-time axis instead. Miscellaneous theme.params.padding - removed, use chartPadding instead.All Series series[].listeners[]:.nodeClick - removed, use .seriesNodeClick instead..nodeDoubleClick - removed, use .seriesNodeDoubleClick instead. Behaviour Changes The full list of behaviour changes across all features for version 12.0.
Behaviour Changes This release includes the following behaviour changes:
Series When Bubble Series labelKey is not provided, the sizeKey is used for the label text instead of the yKey. Series with a labelKey defined will show the label value in the tooltip. Axes Vertical time and ordinal-time axes are now sorted with the earliest date at the top. Use reverse to change this. Default label formats for time and ordinal-time axes have been improved. Axis thickness defaults to a maximum of 30% of the chart size. Theme Defaults If the stroke property is provided, a default strokeWidth will be used to display a stroke. When the Mini Chart is enabled, the Navigator default height is 40px. The following theme.params defaults have changed which will result in very slight colour changes.foregroundColor is changed from #464646 to #181d1f.axisColor is changed from #c3c3c3 to #b4b6b6.borderColor is changed from #dddddd to rgba(24, 29, 31, 0.15).chromeBackgroundColor is changed from #fafafa to #fafafb.crosshairLabelBackgroundColor is changed from #464646 to #181d1f.foregroundColor is changed from #464646 to #181d1f.gridLineColor is changed from #e0eaf2 to #e8e8e9.inputTextColor is changed from #464646 to #181d1f.subtleTextColor is changed from #8c8c8c to #707374.textColor is changed from #464646 to #181d1f. New popupShadow and focusShadow are added to theme.params and will appear around popup dialogues. Other Changes zoom.autoScaling defaults to true. Use enabled: false to disable."Reset Zoom" is added to the default Context Menu items. Provide explicit contextMenu.items change this. Deprecations Deprecations This release includes the following deprecations:
time import is deprecated. Use an AgTimeInterval string directly, or an AgTimeIntervalUnit object instead.AgTimeInterval of utcYear, utcMonth, utcDay, utcHour are removed, use an AgTimeIntervalUnit object with utc: true instead.AgTimeInterval of week is removed. Use an AgTimeIntervalUnit object with { unit: 'day', 'step: 7' } and a format of %a or %A instead.highlightStyle is removed from all series except treemap and sunburst. Use highlight options instead. Removal of Deprecated Properties The following properties have been deprecated since version 11 and have now been removed.
Removed Deprecated Properties zoom.minVisibleItemsX and zoom.minVisibleItemsY - removed. Use zoom.minVisibleItems instead.tooltip.position.type in both chart and series options - removed. Use tooltip.position.anchorTo and/or tooltip.position.placement instead.minVisibleItemsX and minVisibleItemsY have been removed in favour of minVisibleItemscontextMenu.extraActions[], contextMenu.extraSeriesAreaActions[], contextMenu.extraNodeActions, and contextMenu.extraLegendItemActions - removed. Use contextMenu.items[] with the appropriate showOn value instead. Changes List See the full list of changes in the AG Charts 12.0 changelog .