Features

• package.json for ES2015 package has been properly updated with new version dependencies.

Fixes

• Fixed another issue with label text with a lot of in-line formatting not wrapping properly.
• ForceDirectedTree was not updating label maxWidth on zoom.
• Legend's position = "absolute" was not working.

Features

• You are now able to add BOM code when exporting to CSV.
• The userClassName now supports multiple class names separated by a space.
• Upgraded pdfmake to 0.2.2 to work around security issues in older version.
• Upgraded XLSX to 0.17.0 to work around security issues in older version.

Fixes

• In some cases axis labels could be hidden across multiple data updates.
• Fixed issue with stacked/clustered negative values.
• MapChart now respects home* zoom/position with externally loaded geodata.
• Sizing/positioning of 3D charts with titles fixed.
• RangeSelector plugin: fixed zoom range resetting issues.
• Issue with inverted radial axis fixed.
• Axis with snapToSeries set was snapping to hidden series.
• Using timezone was causing DateAxis tooltips to show incorrect time in some cases.
• Issue with label text with a lot of in-line formatting not wrapping properly fixed.

Fixes

• In-line formatting of labels was triggering errors on pages with strict CSP rules.

Fixes

• Export: dynamic CSS <style> added by Export was not applying global nonce option.
• RangeSelector plugin: some pre-set period buttons were behaving incorrectly when there was no animated theme enabled.
• In some cases labels for ValueAxis were prone to a floating-point issue.
• OverlapBuster plugin. Was not always working properly without animated theme.
• Minor tweak to multiple series tooltip arrangements.
• JSON config: sometimes items pushed to children were not being created.
• Truncation of Legend's labels sometimes were being knocked off by the XYCursor activities.

Fixes

• SliceGrouper was not working when chart was a child of another Container.
• SliceGrouper was not updating properly when am4core.options.queue = true was set.
• DateAxis labels were showing zeros instead of proper milliseconds in IE.
• In some cases hidden link in SankeyDiagram could cause rollover tooltip to appear.
• Stroke of the slices in a FunnelChart was not being drawn complete.
• JSON config: value list of the List element was not being properly truncated to supplied lenght.
• JSON config: event list as array was not working properly.
• Using timezone setting in some timezones could offset Series' bullets.
• Absolute pixel width in RadarColumn was being ignored.

Features

• Added new setting for Export: webFontFilter - Allows you to set to a regular expression. If set, only those external fonts with a URL that matches the regular expressions will be loaded.
• Added new setting for ForceDirectedSeries: showOnTick - Render series hidden until Xth tick.
• Added new setting for XYCursor: snapOnPan - Indicates whether to "snap" zoom selection to equal periods when panning by cursor ends.

Fixes

• Zooming of chart with multiple vertical axes of which one was inverted was incorrect.
• minZoomCount was not being taken into account when zooming with mouse wheel.
• JSON config: exporting.dataFields setting was being ignored.
• Creating chart before its container is ready, was resulting in extra element in DOM in some cases.

Fixes

• In some rare cases an critical error could happen on hoverable objects on touch-only displays.
• Zooming and drag-rotating a resized MapChart could throw off the map position.
• It was possible to continue zooming the chart using mouse wheel even when max zoom was reached.
• Zooming "inverted" horizontal axis was incorrect.
• Updating data on SankeyDiagram in some cases could result in an SO.
• TreeMap was showing incorrectly sized nodes with empty children array.
• Sometimes wrapping long strings were causing punctuation at the end of the word to wrap into the next line.
• Dynamically switching logarithmic setting for a ValueAxis was not updating its scale properly in some cases.
• SliceGrouper plugin was not updating properly when manipulating data and/or series.

Fixes

• Fixed issue with toggling multiple ColumnSeries3D.

Features

• Exporting: all adapters related to XLSX export will now have XLSX property holding reference to processor, which needs to be used in order to modify actual workbooks for export.

Fixes

• StepLineSeries might get "stuck" during zoom/data updates in some cases.
• ColumnSeries3D was not staying hidden across data updates.
• Columns on DateAxis were not being positioned properly when changing firstDayOfWeek.
• RangeSelector plugin: YTD was not working properly when data was being grouped to years.
• Disposing chart on a click of a custom ExportMenu item was resulting in JS errors.
• In some setups "ghost paper" (invisible div) was influencing document layout.
• In charts where Series had very small amplitude of values, related ValueAxis could get end up in a dead loop.
• HTML tooltips were not being sized properly in some cases.

Features

• Export: PDF export options now support scale, minWidth, minHeight, maxWidth, and maxHeight options.
• Changed - Setting ignoreZeroValues = true on PieSeries/PyramidSeries will now hide null-value slices, too.

Fixes

• Inserting a new bullet into an initialized Series will now invalidate it cause the new bullet to appear immediately.
• Using timezone might shift axis label values by one day in some cases.
• "i" input date format was not properly parsing formats with no milliseconds and with timezone offset, e.g. ("...+10:30").
• Export: normalizeSVG() method was producing wrong SVG width/height in output if scale parameter was not being passed in.
• RangeSelector plugin: "YTD" pre-defined period was not working properly with some data-grouping setups.

Features

• Changed - DateAxis setting timezone is being deprecated. Please consider setting timezone on chart or axis dateFormatter. DateAxis will now properly place grid in time zones that use non-whole hour fractions, e.g. ("Australia/Adelaide").
• Changed - Accessibility: Roles and tabindexes in ExportMenu elements has been altered to better comply with ARIA standards.

Fixes

• Scrollbar could act funky when repeatedly clicking on its grips.
• A minor conflict with Google Charts lib on IE fixed.
• Improved performance of ValueAxis scale calculation.
• Setting min and max on a DateAxis could result in excessive overzoom and an empty grid in some cases.
• Overzooming DateAxis could result in some extra space shown on it.
• Legend was dynamically adding items on a Treemap chart when drilling-down.
• When Legend's labels' width were set in percent, they were not being properly sized.

Features

• New setting reverseGeodata (default: false) on MapChart and MapSeries. amCharts requires polygon coordinates to be in clockwise order. Some map data have them in counter-clockwise. If your custom map appears garbled, try setting this to true.
• New global option: am4core.options.pixelPerfectPrecision (default: 0). Precision (number of decimal points) to be used when rounding point x/y for elements that have pixelPerfect = true set.

Fixes

• XYChartScrollbar was not inheriting inputDateFormat from the chart properly.
• Clicking on a chart on mobile devices could sometimes make them document scroll a bit.
• Accessibility: pressing ENTER while there is a focused element with showTooltipOn = "hit" will not display its tooltip.
• RangeSelector (plugin) was not properly removing its elements after dispose() it will now auto-dispose when related axis is disposed.
• In some cases a console error could be displayed when using XYCursor over chart when data was being updated.
• Very long labels with wrap = true may have been wrapping incorrectly in some cases.
• JSON config: rgb(...) and rgba(...) syntax was not recognized in ColorSet's baseColor.

Features

• Changed - License check for MapChart was not working. If you are using commercial MapChart, make sure you use addLicense() for both Charts and Maps products.

Fixes

• Better dispose check for delayed "out" event.
• Applying accessibility to some labels with only numeric information was resulting in error.
• Chart could result in an SO in some rare cases.
• Using strictMinMax with includeRangesInMinMax sometimes could caulse wrong zooms.
• In some cases Legend's item labels were being truncated when cahrt container was shrinking, but were not being restored to their full width once it was enlarged back.

Features

• Changed - Export: API functions like getCSV, getSVG, getJSON, getExcel will not error out if no option or format identifier is passed in.

Fixes

• Better invalidation of charts with am4core.options.queue = true enabled.
• A slice in PieSeries remained enlarged (as hovered) after subsequent taps on it on a touch device.
• In some rare cases, on mobile devices a JS error could be invoked when disposing series/axes.
• Vertical ValueAxis was not auto-zooming in some cases.

Features

• New Tooltip property ignoreBounds (default false). If set to true, will not try to contain tooltips within the boundaries of the chart.

Fixes

• Export: Invoking export's getSVG() method without passing in options as a second parameter was resulting in error.
• Series' actual value was not being properly updated in all cases when used with gropuDataItem adapter.
• Series with with extremely small value range could result in an SO.
• Resetting data to an empty data set on an XYSeries with bullets and a data grouping enabled, could result in bullets being left on the screen.

Fixes

• numberFormatter inheritance was broken for XYSeries elements like bullets since last version.
• Chart with a CategoryAxis and XYCursor was erroring when number-based categories were used in data.

Features

• SVG export options now support scale, minWidth, minHeight, maxWidth, and maxHeight.
• New ExportMenu property: element (a reference to menu's top element).

Fixes

• readerTitle and readerDescription were not being properly populated with data on Map objects.
• Setting includeRangesInMinMax = true on ValueAxis in some cases was messing up the chart.
• Export: Printing via iframe in IE11 was distorting the chart aspect ratio.
• Export: Exporting in IE11 was leaving behind a stray <canvas> element afterwards.
• Auto-zoom on ValueAxis was not working properly with multiple series with incomplete data.

Features

• Changed - Inline curly-bracket data placeholders now support dot-separated data context names as literal strings, e.g. "my.custom.property".
• Changed - A bunch of dependencies were updated to latest versions.

Fixes

• Toggling rtl value on an existing Label was (still) not working properly.
• showSystemTooltip was being ignored since last version (4.10.4).
• chart.cursor.snapToSeries was not causing cursor to snap in wrong place if groupData was enabled.
• Bullet tooltip was being hidden even if it had to stay when cursor moved out of the plot area.

Features

• Changed - Accessibility: ExportMenu top item has now role menubar rather than menu.
• Changed - Accessibility: ExportMenu will now set aria-expanded attributes for selected menu items/branches.

Fixes

• Enabling groupData was causing some series not to appear in some cases (since 4.10.3).
• Toggling a legend item was adding a hidden element outside chart container area, which was sometimes causing scrollbars to appear on the web page.
• Toggling rtl value on an existing Label was not working properly.
• Accessibility: setting readerTitle or itemReaderTitle was not setting aria-label but rather adding <desc> tag and aria-describedby attirubute. It now will use aria-label for readerTitle and <desc> for readerDescription.
• Accessibility: there was no way to override hard-coded role of the slices or columns in series.
• Accessibility: navigating ExportMenu with arrow keys will not scroll web page anymore.

Features

• RangeSelector plugin: a new event periodselected added to DateAxisRangeSelector.
• DateFormatter now supports quarter format (code: "q").
• Changed - More prompt translations to Indonesian locale (id_ID).

Fixes

• JSON config: Some axis' title property was being overwritten if it wasn't last option in the properties list.
• SliceGrouper plugin was sometimes not functioning properly when used with options.queue = true.
• Scrollable legend was not resetting back to top if its height changed.
• TreeMap with binaryTree algorithm was producing a JS error if no initial data was set on chart.
• If data grouping on DateAxis was enabled and there were more than one series in the chart, the second and other series were rendered with data ungrouped in the background before rendering them correctly and this was causing performance issues.
• Vertical CurvedColumnSeries with non-inversed CategoryAxis were not positioned properly.

Fixes

• Some SankeyDiagram charts were broken after last release.
• 4.10.0 caused some bullet adapters to kick in earlier which in turn was resulting in critical errors if those adapters relied on dataItem to be present without checking.

Features

• New DateAxis property: timezone. Allows setting timezone to recalculate data in, e.g. "Australia/Sydney". Make sure not to set this on both axis and date formatter.
• New DateFormatter property: timezone. Allows setting timezone to recalculate date objects to before applying the format, e.g. "Australia/Sydney".
• New global option: am4core.options.disableHoverOnTransform ("never" (default), "touch", always)). Allows disabling all hover activity when some element is being dragged or resized.
• Changed - Now SankeyLink that points "backwards" will be applied "backwards" state (if created) so you can style it differently than regular links.

Fixed

• Accessibility: data placeholder population was not working on bullets if Animated theme was not enabled.
• Tapping on a chart with Cursor was triggering an on-screen keyboard on some mobiles devices.
• Some TypeScript warnings were fixed.
• A chart with DateAxis and groupData = true could result a JS error if a series had bullets and a lots of data points.
• In a chart with DateAxis and groupData = true, if a series was hidden when zoomed-in, then zoomed-out, and then unhidden, the related ValueAxis was not updating it's min/max to available value range.
• In some cases a heat rule could result in infinity value which would lead to drawing errors.
• Errors when cloning a RadarChart from a template fixed.
• SankeyDiagram used to produce stack overflow error if data contained backward links. Now it will correctly draw a link.

Features

• New LineSeries property: smoothing ("bezier" (default), "monotoneX", and "monotoneY") - indicates algorithm to use for smoothing the lines. Monotone algos are better suited for irregularly-spaced data.
• ForcedDirectedTree: new property zoomable (default: false). If set to true, the chart will be zoomable/draggable using mouse, touch, or API.
• ForcedDirectedTree: zoom related properties added. mouseWheelBehavior ("zoom", "none") - controls what happens when mouse wheel is used over chart; zoomStep (default: 2) - step to increase zoom level my each zoom in; zoomOutButton - an instance of button which is shown when chart is zoomed in.
• ForcedDirectedTree: new zoom-related methods: zoomToPoint(point, level, center) and zoomToDataItem(dataItem, level, center).
• New global function: am4core.createDeferred(callback, scope, ...parameters). Can be used to create multiple charts in a truly safe daisy-chain (next chart starts to be instantiated only when previous triggers a ready event). Returns a Promise with chart instance.
• New global option: am4core.options.deferredDelay (default 100). Specifies time-gap in milliseconds between deferred chart instantiations.
• Changed - Added date ordinal translations for Chinese locales.

Fixes

• Accessibility: readerTitle was not being properly populated with data on Label.
• Accessibility: readerDescription was not being populated with data.
• Now works with Angular Universal SSR. Please refer to our Angular doc for instructions on how to structure your app for SSR to work properly.
• When MapChart was panned with inertia and a polygon with zoomToObject() hit event was clicked when the map was still moving, the map was zooming into a wrong position.