UNPKG

210 kBMarkdownView Raw
1# amCharts 4 Changelog
2
3The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/).
4
5Please note, that this project, while following numbering syntax, it DOES NOT
6adhere to [Semantic Versioning](http://semver.org/spec/v2.0.0.html) rules.
7
8## [4.10.25] - 2022-04-19
9
10### Added
11- `baseValue` added to `ForceDirectedSeries` (default: `0`). Used for calculating node radius.
12
13### Fixed
14- `focusFilter` property was not being cloned.
15- Setting `tabindex` to a negative value was not working properly.
16
17
18## [4.10.24] - 2022-02-14
19
20### Changed
21- When auto-wrapping labels, text will no longer break on dots to prevent fractional numbers from wrapping.
22
23### Fixed
24- Multiple square bracket and apostrophe escaping was not working properly.
25
26
27## [4.10.23] - 2021-11-25
28
29### Added
30- New `NumberFormatter` setting: `forceLTR`. If set to `true` will force all numbers to be formatted as LTR, even if RTL is enabled.
31
32### Changed
33- Using minified version of `xlsx` library for XLSX exports.
34
35### Fixed
36- If chart queuing was enabled and chart was disposed quickly before it had a chance to initialize, it was resulting in a critical error.
37- In some cases (after programmatic hover) tapping on a touch device could produce an error in `MapChart`.
38- JSON config: in some cases items in `children` were not being created.
39- Mouse wheel zooming was not working properly in recent versions of Firefox.
40- Fixing security vulnerability ([`CVE-2021-3807`](https://nvd.nist.gov/vuln/detail/CVE-2021-3807)) with `venn.js` dependency.
41- Tweaking hover styles for `ExportMenu` CSS so they do not get invoked unless hovered on chart's container.
42- Reader labels were not being updated on Scrollbar elements when data in chart was updated.
43- `Annotation` plugin will now not go into edit mode after `data` is set.
44- In some cases wrapped and center-aligned axis labels could get a bit offset.
45- In some cases toggling series on and off was not updating related value axis scale on lazy-loaded charts.
46
47
48## [4.10.22] - 2021-08-20
49
50### Changed
51- `package.json` for ES2015 package was properly updated with new version dependencies.
52
53### Fixed
54- Another issue with label text with a lot of in-line formatting not wrapping properly fixed.
55- ForceDirectedTree was not updating label `maxWidth` on zoom.
56- Legend's `position = "absolute"` was not working.
57
58
59## [4.10.21] - 2021-08-08
60
61### Added
62- Export: new setting in CSV options: `addBOM` (default `true`).
63
64### Changed
65- `userClassName` now supports multiple class names separated by space.
66- Exporting CSV will now have add BOM code to exported file.
67- Upgrading to `pdfmake 0.2.2` to work around security issues in older version.
68- Upgrading to `xlsx 0.17.0` to work around security issues in older version.
69
70### Fixed
71- In some cases axis labels could be hidden across multiple data updates.
72- Fixed issue with stacked/clustered negative values.
73- `MapChart` now respects `home*` zoom/position with externally loaded geodata.
74- Sizing/positioning of 3D charts with titles fixed.
75- RangeSelector plugin: fixed zoom range resetting issues.
76- Issue with inverted radial axis fixed.
77- Axis with `snapToSeries` set was snapping to hidden series.
78- Using timezone was causing `DateAxis` tooltips to show incorrect time in some cases.
79- Issue with label text with a lot of in-line formatting not wrapping properly fixed.
80
81
82## [4.10.20] - 2021-06-17
83
84### Fixed
85- In-line formatting of labels was triggering errors on pages with strict CSP rules.
86
87
88## [4.10.19] - 2021-06-08
89
90### Fixed
91- Export: dynamic CSS `<style>` added by `Export` was not applying global `nonce` option.
92- `RangeSelector` plugin: some pre-set period buttons were behaving incorrectly when there was no animated theme enabled.
93- In some cases labels for `ValueAxis` were prone to a floating-point issue.
94- `OverlapBuster` plugin. Was not always working properly without animated theme.
95- Minor tweak to multiple series tooltip arrangements.
96- JSON config: sometimes items pushed to `children` were not being created.
97- Truncation of Legend's labels sometimes were being knocked off by the `XYCursor` activities.
98
99
100## [4.10.18] - 2021-04-21
101
102### Fixed
103- `SliceGrouper` was not working when chart was a child of another `Container`.
104- `SliceGrouper` was not updating properly when `am4core.options.queue = true` was set.
105- `DateAxis` labels were showing zeros instead of proper milliseconds in IE.
106- In some cases hidden link in `SankeyDiagram` could cause rollover tooltip to appear.
107- Stroke of the slices in a `FunnelChart` was not being drawn complete.
108- JSON config: value list of the `List` element was not being properly truncated to supplied lenght.
109- JSON config: event list as array was not working properly.
110- Using `timezone` setting in some timezones could offset Series' bullets.
111- Absolute pixel `width` in `RadarColumn` was being ignored.
112
113
114## [4.10.17] - 2021-03-19
115
116### Added
117- New setting for `Export`: `webFontFilter`. Allows it to set to a regular expression. If set only those external fonts that their URL match regular exporession will be loaded.
118- New setting for `ForceDirectedSeries`: `showOnTick` (default `10`). Render series hidden until Xth tick.
119- New setting for `XYCursor`: `snapOnPan` (default `true`). Indicates whether to "snap" zoom selection to equal periods when panning by cursor ends.
120
121### Fixed
122- Zooming of chart with multiple vertical axes of which one was inverted was incorrect.
123- `minZoomCount` was not being taken into account when zooming with mouse wheel.
124- JSON config: `exporting.dataFields` setting was being ignored.
125- Creating chart before its container is ready, was resulting in extra element in DOM in some cases.
126
127
128## [4.10.16] - 2021-03-03
129
130### Fixed
131- In some rare cases an critical error could happen on hoverable objects on touch-only displays.
132- Zooming and drag-rotating a resized `MapChart` could throw off the map position.
133- It was possible to continue zooming the chart using mouse wheel even when max zoom was reached.
134- Zooming "inverted" horizontal axis was incorrect.
135- Updating data on `SankeyDiagram` in some cases could result in an SO.
136- `TreeMap` was showing incorrectly sized nodes with empty children array.
137- Sometimes wrapping long strings were causing punctuation at the end of the word to wrap into the next line.
138- Dynamically switching `logarithmic` setting for a `ValueAxis` was not updating its scale properly in some cases.
139- `SliceGrouper` plugin was not updating properly when manipulating data and/or series.
140
141
142## [4.10.15] - 2021-02-03
143
144### Fixed
145- Fixed issue with toggling multiple `ColumnSeries3D` (introduced in last version).
146
147
148## [4.10.14] - 2021-02-02
149
150### Added
151- Exporting: all adapters related to XLSX export, will now have `xslx` property holding reference to processor, that needs to be used in order to modify actual workbooks for export.
152
153### Fixed
154- `StepLineSeries` might get "stuck" during zoom/data updates in some cases.
155- `ColumnSeries3D` was not staying hidden across data updates.
156- Columns on `DateAxis` were not being positioned properly when changing `firstDayOfWeek`.
157- RangeSelector plugin: YTD was not working properly when data was being grouped to years.
158- Disposing chart on a click of a custom `ExportMenu` item was resulting in JS errors.
159- In some setups "ghost paper" (invisible div) was influencing document layout.
160- In charts where Series had very small amplitude of values, related `ValueAxis` could get end up in a dead loop.
161- HTML tooltips were not being sized properly in some cases.
162
163
164## [4.10.13] - 2020-12-18
165
166### Added
167- Export: PDF export options now support `scale`, `minWidth`, `minHeight`, `maxWidth`, and `maxHeight` options.
168
169### Changed
170- Setting `ignoreZeroValues = true` on `PieSeries`/`PyramidSeries` will now hide `null`-value slices, too.
171
172### Fixed
173- Inserting a new bullet into an initialized Series will now invalidate it cause the new bullet to appear immediately.
174- Using `timezone` might shift axis label values by one day in some cases.
175- `"i"` input date format was not properly parsing formats with no milliseconds and with timezone offset, e.g. (`"...+10:30"`).
176- Export: `normalizeSVG()` method was producing wrong SVG width/height in output if scale parameter was not being passed in.
177- RangeSelector plugin: "YTD" pre-defined period was not working properly with some data-grouping setups.
178
179
180## [4.10.12] - 2020-11-26
181
182### Changed
183- `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").
184- Accessibility: Roles and tabindexes in `ExportMenu` elements has been altered to better comply with ARIA standards.
185
186### Fixed
187- Scrollbar could act funky when repeatedly clicking on its grips.
188- A minor conflict with Google Charts lib on IE fixed.
189- Improved performance of `ValueAxis` scale calculation.
190- Setting `min` and `max` on a `DateAxis` could result in excessive overzoom and an empty grid in some cases.
191- Overzooming `DateAxis` coul dresult in some extra space shown on it.
192- Legend was dynamically adding items on a Treemap chart when drilling-down.
193- When Legend's labels' `width` were set in percent, they were not being properly sized.
194
195
196## [4.10.11] - 2020-11-13
197
198### Added
199- 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`.
200- 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.
201
202### Fixed
203- `XYChartScrollbar` was not inheriting `inputDateFormat` from the chart properly.
204- Clicking on a chart on mobile devices could sometimes make them document scroll a bit.
205- Accessibility: pressing ENTER while there is a focused element with `showTooltipOn = "hit"` will not display its tooltip.
206- RangeSelector (plugin) was not properly removing its elements after `dispose()` it will now auto-dispose when related axis is disposed.
207- In some cases a console error could be displayed when using `XYCursor` over chart when data was being updated.
208- Very long labels with `wrap = true` may have been wrapping incorrectly in some cases.
209- JSON config: `rgb(...)` and `rgba(...)` syntax was not recongnised in `ColorSet`'s `baseColor`.
210
211
212## [4.10.10] - 2020-11-03
213
214### Changed
215- License check for `MapChart` was not working. If you are using commercial `MapChart`, make sure you use `addLicense()` for both Charts and Maps products.
216
217### Fixed
218- Better dispose check for delayed `"out"` event.
219- Applying accessibility to some labels with only numeric information was resulting in error.
220- Chart could result in an SO in some rare cases.
221- Using `strictMinMax` with `includeRangesInMinMax` sometimes could caulse wrong zooms.
222- 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.
223
224
225## [4.10.9] - 2020-10-23
226
227### Changed
228- Export: API functions like `getCSV`, `getSVG`, `getJSON`, `getExcel` will not error out if no opeionts or format identifier is passed in.
229
230### Fixed
231- Better invalidation of charts with `am4core.options.queue = true` enabled.
232- A slice in `PieSeries` remained enlarged (as hovered) after subsequent taps on it on a touch device.
233- In some rare cases, on mobile devices a JS error could be invoked when disposing series/axes.
234- Vertical `ValueAxis` was not auto-zooming in some cases.
235
236
237## [4.10.8] - 2020-10-19
238
239### Added
240- New `Tooltip` property `ignoreBounds` (default `false`). If set to `true`, will not try to contain tooltips within the boundaries of the chart.
241
242### Fixed
243- Export: Invoking export's `getSVG()` method without passing in options as a second parameter was resulting in error.
244- Series' actual value was not being properly updated in all cases when used with `gropuDataItem` adapter.
245- Series with with extremely small value range could result in an SO.
246- Resetting data to an empty data set on an `XYSeries` witth bullets and a data grouping enabled, could result in bullets being left on the screen.
247
248
249## [4.10.7] - 2020-10-10
250
251### Fixed
252- `numberFormatter` inheritance was broken for `XYSeries` elements like bullets since last version.
253- Chart with a `CategoryAxis` and `XYCursor` was erroring when number-based categories were used in data.
254
255
256## [4.10.6] - 2020-10-09
257
258### Added
259- SVG export options now support `scale`, `minWidth`, `minHeight`, `maxWidth`, and `maxHeight`.
260- New `ExportMenu` property: `element` (a reference to menu's top element).
261
262### Fixed
263- `readerTitle` and `readerDescription` were not being properly populated with data on Map objects.
264- Setting `includeRangesInMinMax = true` on `ValueAxis` in some cases was messing up the chart.
265- Export: Printing via iframe in IE11 was distorting the chart aspect ratio.
266- Export: Exporting in IE11 was leaving behind a stray `<canvas>` element afterwards.
267- Auto-zoom on `ValueAxis` was not working properly with multiple series with incomplete data.
268
269
270## [4.10.5] - 2020-10-02
271
272### Changed
273- Inline curly-bracket data placeholders now support dot-separated data context names as literal strings, e.g. `"my.custom.property"`.
274- A bunch of dependencies were updated to latest versions.
275
276### Fixed
277- Toggling `rtl` value on an existing `Label` was (still) not working properly.
278- `showSystemTooltip` was being ignored since last version (4.10.4).
279- `chart.cursor.snapToSeries` was not causing cursor to snap in wrong place if `groupData` was enabled.
280- Bullet tooltip was being hidden even if it had to stay when cursor moved out of the plot area.
281
282
283## [4.10.4] - 2020-09-22
284
285### Changed
286- Accessibility: `ExportMenu` top item has now role `menubar` rather than `menu`.
287- Accessibility: `ExportMenu` will now set `aria-expanded` attributes for selected menu items/branches.
288
289### Fixed
290- Enabling `groupData` was causing some series not to appear in some cases (since 4.10.3).
291- Toggling a legend item was adding a hidden element outside chart container area, which was sometimes causing scrollbars to appear on the web page.
292- Toggling `rtl` value on an existing `Label` was not working properly.
293- Accessibility: setting `rederTitle` 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`.
294- Accessibility: there was no way to override hard-coded `role` of the slices or columns in series.
295- Accessibility: navigating `ExportMenu` with arrow keys will not scroll web page anymore.
296
297
298## [4.10.3] - 2020-09-19
299
300### Added
301- RangeSelector plugin: a new event `periodselected` added to `DateAxisRangeSelector`.
302- `DateFormatter` now supports quarter format (code: `"q"`).
303
304### Changed
305- More prompt translations to Indonesian locale (`id_ID`).
306
307### Fixed
308- JSON config: Some axis' `title` property was being overwritten if it wasn't last option in the properties list.
309- SliceGrouper plugin was sometimes not functioning properly when used with `options.queue = true`.
310- Scrollable legend was not resetting back to top if its height changed.
311- `TreeMap` with `binaryTree` algorithm was producing a JS error if no initial data was set on chart.
312- 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 thiswas causing performance issues.
313- Vertical `CurvedColumnSeries` with non-inversed `CategoryAxi`s were not positioned properly.
314
315
316## [4.10.2] - 2020-09-08
317
318### Fixed
319- Some `SankeyDiagram` charts were broken after last release.
320- `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.
321
322
323## [4.10.1] - 2020-09-07
324
325### Added
326- 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.
327- New `DateFormatter` property: `timezone`. Allows setting timezone to recalculate date objects to before applying the format, e.g. `"Australia/Sydney"`.
328- New global option: `am4core.options.disableHoverOnTransform` (`"never"` (default), `"touch"`, `always`)). Allows disabling all hover activity when some element is being dragged or resized. [More info](https://www.amcharts.com/docs/v4/concepts/touch/#Hover_functionality).
329
330### Changed
331- Now `SankeyLink` that points "backwards" will be applied `"backwards"` state (if created) so you can style it differently than regular links.
332
333### Fixed
334- Accessibility: data placeholder population was not working on bullets if Animated theme was not enabled.
335- Tapping on a chart with `Cursor` was triggering an on-screen keyboard on some mobiles devices.
336- Some TypeScript warnings were fixed.
337- A chart with `DateAxis` and `groupData = true` could result a JS error if a series had bullets and a lots of data points.
338- 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.
339- In some cases a heat rule could result in infinity value which would lead to drawing errors.
340- Errors when cloning a `RadarChart` from a template fixed.
341- `SankeyDiagram` used to produce stack owerflow error if data contained backward links. Now it will correctly draw a link.
342
343
344## [4.10.0] - 2020-09-01
345
346### Added
347- 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. [More info](https://www.amcharts.com/docs/v4/chart-types/xy-chart/#Alternate_smoothing_algorithm).
348- `ForcedDirectedTree`: new property `zoomable` (default: `false`). If set to `true`, the chart will be zoomable/draggable using mouse, touch, or API. [More information](https://www.amcharts.com/docs/v4/chart-types/force-directed/#Zooming).
349- `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.
350- `ForcedDirectedTree`: new zoom-related methods: `zoomToPoint(point, level, center)` and `zoomToDataItem(dataItem, level, center)`;
351- 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. [More information](https://www.amcharts.com/docs/v4/concepts/performance/#Deferred_daisy_chained_instantiation);
352- New global option: `am4core.options.deferredDelay` (default `100`). Specifies time-gap in milliseconds between deferred chart instantiations.
353
354### Changed
355- Added date ordinal translations for Chinese locales.
356
357### Fixed
358- Accessibility: `readerTitle` was not being properly populated with data on `Label`.
359- Accessibility: `readerDescription` was not being populated with data.
360- Now works with Angular Universal SSR. Please refer to our [Angular doc](https://www.amcharts.com/docs/v4/getting-started/integrations/using-angular2/) for instructions on how to structure your app for SSR to work properly.
361- 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.
362
363
364## [4.9.37] - 2020-08-21
365
366### Fixed
367- Colors for markers in Legend with `useDefaultMarkers = true` were broken since last release.
368
369
370## [4.9.36] - 2020-08-20
371
372### Added
373- New adapter on `XYSeries`: `groupDataitem`. When data grouping occurs, each aggregate data item will be passed through this adapter, where you can modify its aggregate value. [More info](https://www.amcharts.com/docs/v4/tutorials/using-custom-functions-for-data-item-grouping/).
374- Two new `MapPolygonSeries` properties: `sortPolygonsBy` ( `"area"` (default), `"name"`, `"longitude"`, `"latitude"`, `"id"`, and `"none"`) and `sortPolygonsReversed` (default `false`).
375
376### Fixed
377- Export: `fontSize` option was being ignored when exporting data in PDF.
378- Better format object type checks in `DateFormatter` and `NumberFormatter`.
379- Older (non-Chromium) EDGE browser was not showing patterns in the legend markers.
380- If a stacked series was hidden with data item grouping enabled and then axis zoomed in or zoomed out so that group perdiod changes, series were stacked on the wrong position.
381- `CircularAxis` line was flickering while start/end angle was animating.
382
383
384## [4.9.35] - 2020-08-12
385
386### Added
387- New adapter on `XYSeries`: `groupValue`. It's now possible to apply custom aggregate value calculation functions for grouped data items. [More info](https://www.amcharts.com/docs/v4/tutorials/using-custom-functions-for-data-item-grouping/).
388- New adapter on `Cursor`: `cursorPoint`. Use it to custom-position chart cursor using your own logic.
389
390### Changed
391- Accessibility: Now if ENTER is pressed when object with an enabled `"hit"` event is focused, that event will be triggered automatically.
392- Clicking anywhere on the plot area with `XYCursor` will now trigger blur on any focused element on the page (consistent to clicking anywhere else on the document).
393
394### Fixed
395- RangeSelector plugin was not properly inheriting chart's locale.
396- `"x"` (timestamp) in `inputDateFormat` was not working properly.
397- If all values of `SankeyDiagram` were `0` (zero), nodes were not being arranged and their rectangles were not being displayed.
398- First `CategoryAxis` label was not visible if `minGridDistance` was set to `0` (zero).
399- Old series bullets of an `XYSeries` remained visible when data was updated and data grouping was enabled on related `DateAxis`.
400- `Utils.random()` function was not returning value in proper from/to range.
401- Stacking now works only between series of the same type. Previously a `LineSeries` between two stacked `ColumnSeries` could mess up stacking for the latter.
402- Zooming in on a part of `LineSeries` which had `strokeDashArray` enabled via `propertyFields` was making the whole line dashed.
403- On a chart with `XYCursor` hovering on category with a null value for some series, used to display a tooltip for a different category in some cases.
404
405
406## [4.9.34] - 2020-07-31
407
408### Added
409- New bullet `ShapeBullet` in `Bullets` plugin. Please refer to [this documentation article](https://www.amcharts.com/docs/v4/tutorials/plugin-bullets/) for more info.
410- `treatZeroAs` added to `ValueAxis`. Use it to work around zero-value restriction on a logarithmic scale.
411- `stackToNegative` (default: `true`) added to `XYSeries`. Determines whether negative values in a stack will stack in relation to base (zero) line (`true`; default) or in relation to the previous value in the stack (`false`).
412
413### Changed
414- [xlsx](https://www.npmjs.com/package/xlsx) dependency was updated from `0.15.4` to `0.16.4`.
415- Tooltip snapping on `DateAxis` now takes Series' location into account.
416
417### Fixed
418- Regression plugin: `reorder` option was not working properly.
419- `snapToSeries` was not working properly if there was a hidden Series with exactly the same value as the other visible Series.
420- `TreeMap` and `ForceDirectedTree` with a single data item and no children were not working properly with chart legend.
421- Horizontal (X) Axis tooltip in a very small document was sometimes positioned with an offset.
422- `zoomToRectangle()` method of `MapChart` with `deltaLongitude` was not working properly if a rectangle crossed the 180 meridian.
423
424
425## [4.9.33] - 2020-07-23
426
427### Fixed
428- If an item from a chart with `CategoryAxis` was removed and then a new item with the same category name was added, chart was not rendering the new item.
429- A chart with multiple series starting/ending not at the same position could result in wrong zoom on `ValueAxis`
430- Last bullet/column from `XYSeries` could disappear if end date was not exact as last data items date.
431- `LineSeries` could skip a point in case distance between data points was very small, resulting in incorrect line series.
432
433
434## [4.9.32] - 2020-07-23
435
436- Nothing here. Version number snafu.
437
438
439## [4.9.31] - 2020-07-21
440
441### Changed
442- Global adapters are being deprecated due to performance reasons. They will still work on some properties, but may be turned off at some future version. If you are using `am4core.globalAdapter`, please consider refactoring your code in some other way.
443- If `groupInterval` is manually set, `DateAxis` now prepares all intervals. Normally, the chart does not prepare data sets for time intervals longer than the span of dates in the data. This causes problem in case user sets these intervals manually using `groupInterval`. Note, the groupInterval must be set initially, before data parsing in order data to be grouped into all groupIntervals.
444
445### Fixed
446- "Year of week" (`YYYY`) was not being calculated correctly by `DateFormatter`.
447- Regression plugin was not working correctly in an all-`ValueAxis` scenarios.
448- `ColumnSeries` were not working with `dropFromPreviousState`.
449- If data was changed on a chart which was zoomed and there were less data items in the new data than there was before, a JS error was triggered.
450- Sometimes a chart with `XYChartScrollbar` with series in it could produce a JS error if series has its `fillOpacity > 0`.
451- Series in an `XYChartScrollbar` was not being shown if `options.onlyShowOnViewport = true`.
452- `zoomToRectangle()` call was resulting in an error if called after the `MapChart` was rotated.
453- `CurvedColumnSeries` columns were not being filled with proper color (black was being used instead).
454- A chart with multiple series starting/ending not at the same position could result in wrong zoom on `ValueAxis`.
455- `DateAxis` with millisecond `baseInterval` sometimes could show one millisecond less than actual data point in its tooltip.
456
457
458## [4.9.30] - 2020-07-10
459
460### Added
461- `am4core.options.suppressWarnings` global option added (default: `false`). If set to `true`, the charts won't output any warnings into console (e.g. "Chart was not disposed").
462
463### Fixed
464- Drill-down map with `geodataSource` problem fixed (since last release only).
465- Issues with cursor/tooltip and other element positioning fixed, when chart was being initialized outside of DOM (no container on init).
466
467
468## [4.9.29] - 2020-07-09
469
470### Changed
471- Export: data exported as HTML will now have `<thead>` and `<tbody>` tags.
472- `XYChart.getClosest()` method is now public.
473- Accessibility: Now pressing ENTER while there's a `MapChart` element focused (using TAB key) will invoke its `hit` event, if set.
474
475### Fixed
476- JSON: heat rules referring to series' bullets were not working, e.g. `target: "bullet[0].circle"`.
477- IE: More fixes to polyfill overriding.
478- `ColorSet` method `next()` would fail if `currentStep` was bigger than `minColors`, affecting `SliceGrouper` plugin setups with a lot of slices in particular.
479- On `MapChart` settings `minZoomLevel` and `maxZoomLevel` were being ignored when pinch-zooming.
480- Syncing of axes improved, especially when series of one axis were hidden/shown.
481- If a `MapSeries` had its geodata loaded via `geodataSource`, the map used to disappear after div size changed.
482- Legend had a `maxWidth` set to `200` and this could result labels to be truncated even if there was enough space for them to fit in.
483- Ticks/grid could disappear if `ValueAxis` had `min`/`max` set and data of a chart changed.
484
485
486## [4.9.28] - 2020-06-29
487
488### Added
489- New adapter `xlsxWorkbook` in `Export`. Will allow decorating a Workbook object before it is exported.
490- `chart.exporting` text-based API functions (`getSVG()`, `getCSV()`, `getJSON()`, `getHTML()`) now have third parameter (boolean). If set to `false` they will return a raw output, rather than data:uri.
491- `zoomable` property added to all axes (default: `true`). Setting it to `false` will make axis not react to zoom events from scrollbar/cursor.
492
493### Changed
494- Removed `focusable` from map chart background series.
495- Polyfills in `.js` file will now only load on-demand, making it with some frameworks that override default objects.
496
497### Fixed
498- Regression plugin: the regression line was not being drawn correctly on a chart with horizontal `ValueAxis`.
499- Export: images exported on zoomed-out pages sometimes were showing visual artifacts.
500- If a chart cursor was visible (because of soft or hard `triggerMove()` calls) but the real mouse was out of the plot area, the cursor used to react to clicks even though it shouldn't have.
501- `ForceDirectedNode`'s `fill` and `stroke` adapters were not working properly if nodes were initially collapsed.
502- `Sprite.hitTest()` method was not working properly with `nonScaling = true`.
503- If a `MapChart` had geodata loaded via `geodataSource.url`, the map used to disappear after div size changed.
504- If a legend of a `MapChart` was disposed, a JS error might happen in some cases.
505
506
507## [4.9.27] - 2020-06-18
508
509### Added
510- `ExportMenu` item definition can now have `title` property. If set, it will be added to item's `title` property, which should show a system tooltip on hover.
511
512### Changed
513- Hex color parser now supports RGBA format which includes alpha value, e.g. `"#FF000080"` will produce a 50% transparent red.
514
515### Fixed
516- Fixed performance issue with a logarithmic `ValueAxis` with `strictMinMax` set to `true`.
517- Calculated value of `sum` in the selection of an `XYChart` could include one extra data item, not visible in the selection.
518- Pie slices with 0 values were sorted incorrectly in FF.
519
520
521## [4.9.26] - 2020-06-07
522
523### Fixed
524- Series with `showOnInit = false` were not shown on a chart initially (since last release only).
525
526
527## [4.9.25] - 2020-06-06
528
529### Added
530- Global option `am4core.options.autoDispose` added (default `false`). If set to `true`, when chart is being created in a container that has already existing chart, instead of "Chart was not disposed" warning in console, the chart being overwritten will be disposed.
531- New plugin: [Range Selector](https://www.amcharts.com/docs/v4/tutorials/plugin-range-selector/). Collection of controls for adding alternative zoom controls for axes.
532
533### Changed
534- Disabled callbacks will now carry over to a clone when cloning an Adapter.
535
536### Fixed
537- Export: Sometimes background was improperly clipped when upscaling exported image.
538- Export: If chart's `data` was updated open `ExportMenu` was forcibly being closed.
539- `"Z"` and `"ZZ"` indicators in `inputDateFormat` were being ignored.
540- If series had `sequencedInterpolation = true` set and it was hidden via legend, its legend item lost disabled color when chart was resized.
541- `bullet.locationX` and `bullet.locationY` was being ignored on a `ColumnSeries` with `CategoryAxis`.
542- If a chart's Legend was disposed, it could result in JS errors if chart had an `XYCursor` enabled.
543
544
545## [4.9.24] - 2020-05-29
546
547### Added
548- Export: New image export options: `minWidth`, `minHeight`, `maxWidth`, and `maxHeight`. Control minimum and maximum dimensions of the target image.
549- Chart can now be initialized without target container (`am4core.create(undefined, ...)`) then, when needed placed into container using `chart.moveHtmlContainer(target)` (where `target` can either be id or a reference of DOM element).
550- `groupInterval` property added to `DateAxis`. You can use it to force certain grouping internal when `groupData = true` instead of one chosen dynamically.
551
552### Changed
553- `stroke`/`fill` settings will now accept values as RGB objects (e.g.: `{ r: 255, g: 0, b: 0 }`).
554- Export: `scale` now scales source SVG before converting to image, instead of resampling target image.
555- Chart will no longer error out if target container by supplied id is not available at the moment of chart's instantiation. It will still error if such container is not available when DOM is ready. This allows placing chart code before actual chart target markup.
556- If Axis has `syncWithAxis = true` set, it is excluded from common zoom range for better syncing.
557
558### Fixed
559- Sometimes responsive rules were not being applied on chart load in Angular apps.
560- `XYCursor` setting `snapToSeries` now uses better precision in placing cursor lines/axis tooltips.
561
562
563## [4.9.23] - 2020-05-19
564
565### Added
566- `removedfromqueue` event added to `Sprite`. It is invoked when `am4core.options.queue = true` or `am4core.options.onlyShowOnViewport = true` and the Sprite (chart) is removed from queue (appears on the screen).
567- `groupperiodchanged` event added to `DateAxis`. It is invoked when data grouping is on and grouping period is changed.
568
569### Fixed
570- JSON: Array value in `snapToSeries` on `XYCursor` was resulting in error.
571- `RadarChart` was resulting in an error if used as a column or bullet template in some other chart.
572- `AxisRendererRadial.innerRadius` was ignored if set in percent and `RadarChart.innerRadius` was not set.
573- Wide charts were being cut off in the middle when printing.
574
575
576## [4.9.22] - 2020-05-14
577
578### Changed
579- Export: Now using forked version of `canvg` until underlying issues are fixed in source library.
580
581### Fixed
582- `queue` and `onlyShowOnViewport` were not working properly on regular `Container` instances.
583- Export: Garbled IE image exports fixed.
584- Some tooltips were reappearing on `MapChart` after their `showToolipOn` was reset back to `"hover"` from `"always"`.
585
586
587## [4.9.21] - 2020-05-13
588
589### Fixed
590- Latest version of `canvg` was causing issues in some Angular setups. Downgraded to `3.0.0`.
591- The legend marker for `LineSeries` with circle bullet was not properly centered.
592
593
594## [4.9.20] - 2020-05-11
595
596### Changed
597- `hit` and `up` events on nested objects will now respect correct bubbling up order.
598- If `rtl` is not set directly on the `Label`, it will now take `rtl` value not from its parent but from `baseSprite` (performance enhancement).
599- `<desc>` element with amCharts attribution removed from generated SVG.
600
601### Fixed
602- Export: PDF export will now fallback to regular fonts if bold fonts don't exist.
603- Export: Advanced PDF exports with extra content were broken since last release.
604- Export: Image export was essentially broken in IEs.
605- `options.nonce` was not working properly on EDGE.
606- Event `selectedned` was not dispatched by `Cursor` if released outside the chart div and behavior was set to `select*`.
607- If all series were removed and then added quickly to the chart with a legend it could result a JS error.
608- Setting `data` directly on a series not right after it was created could result `series.data` array to be shown as empty.
609- It was impossible to set `SwitchButton` as active initially.
610- Fixed snapping cursor to series when data was missing: if series had gaps in data and `cursor.snapToSeries` was set, the snapping was not working properly.
611- When adding data to `XYSeries` which was `XYCharScrollbar`'s series, the raw data was incorrectly modified.
612
613
614## [4.9.19] - 2020-04-30
615
616### Added
617- Export: Two new PDF export options added: `font` and `extraFonts` which enable specifying non-default font to use when exporting PDF. [More info](https://www.amcharts.com/docs/v4/concepts/exporting/#PDF_and_non_Latin_languages).
618
619### Changed
620- Third party resize sensor replaced with a home-brewed, which is faster and more reliable.
621- `svgContainer.resizeSensor` replaced with a dummy object. Make sure you remove all references to it in your code. Calling it's `reset()` method will now generate a warning in console.
622
623### Fixed
624- Inline text formatting blocks now accept quote-enclosed values, e.g. `[font-family: 'Segoe UI']`.
625- Fills for columns in `RadarColumnSeries` were black (since last release).
626- With Chrome 81 disposing the chart in with DevTools open was very slow.
627- Performance optimizations when showing/hiding series with a lot of data.
628- Tooltip was flickering at 0,0 position if animated theme was not enabled.
629
630
631## [4.9.18] - 2020-04-28
632
633### Added
634- Heatmaps can now be logarithmic (set `logarithmic = true` in the heat rule config).
635
636### Fixed
637- Preloader label was misaligned when RTL was enabled.
638- Double "hit" event invocation on `MapPolygon` fixed.
639- Regression plugin: "processed" event was triggered twice on initial chart load.
640- SliceGrouper plugin: if slice templats had any "hit" events set, `clickBehavior = "break"` was not working.
641- IE was not displaying series in `XYChartScrollbar`. On IE now gray fill/stroke is used instead of desaturate filter.
642- IE was not displaying series with filters. Remnoved filters if IE.
643- Fixed issue with zero-value nodes drill-down `SankeyDiagram`.
644- When animations were disabled through options, showing `XYSeries` and `FunnelSeries` after it was hidden was not working.
645- It was not possible to add `MapImages` to `MapImageSeries` directly from the GeoJSON geodata.
646- `maxWidth` set on Legend's label was being ignored.
647- Layout was not being redrawn when `minGridDistance` was set after chart initialization.
648- If `sprite.showTooltipOn = "hit"` and no animated theme was used, tooltip used to flicker at old position before shown in the correct one.
649- EDGE was not showing `ColumnSeries` gradients if gradient was set on series, not on directly on column template.
650
651
652## [4.9.17] - 2020-04-20
653
654### Added
655- Global option `am4core.options.nonce` added. If set, amCharts will use this as a nonce-parameter for all dynamically created stylesheets, so it can be addressed in `Content-Security-Policy` headers.
656- New `Popup` property: `dynamicResize`. If set to `true` (default) and contents contains unloaded images it will resize itself when those finish loading.
657- `gradientUnits` added to `LinearGradient`. If you're setting gradient on a perfectly straight line, set it to `userSpaceOnUse`.
658- `filterUnits` added to `Filter`. If you're setting gradient on a perfectly straight line, set it to `userSpaceOnUse`.
659- `startLocation` and `endLocation` added to `CategoryAxisBreak`. Can use to indicate where exactly within category break should start and end.
660
661### Changed
662- `Popup` now will size itself to accommodate images inside it as they are being loaded. To disable, set `Popup`'s `dynamicResize = false`. Also make sure you enable `maxWidth`/`maxHeight` in your CSS to avoid unreasonably large popups for unsized images.
663
664### Fixed
665- Week number in date format (`"ww"`) was not accounting for daylight saving.
666- Pressing ENTER on a focused Legend item will no longer toggle related series if legend's item containers are sett to be not togglable.
667- Exporting to SVG no longer breaks if chart contains `foreignObject` elements with SVG's in them.
668- Line smoothing (`tensionX` / `tensionY`) now drops out duplicate points to avoid weird loops on overlapping data items.
669- Chart was zooming incorrectly, when data was added directly to stacked series and one of the series was hidden.
670- Some performance issues with `XYCursor` and a lot of series fixed.
671- `LinearGradient` fill was not working on `LineSeries` under EDGE.
672
673
674## [4.9.16] - 2020-04-14
675
676### Fixed
677- Fixed error when compiling Angular app (since 4.9.14).
678
679
680## [4.9.15] - 2020-04-13
681
682### Fixed
683- Straightening of `RadarChart` was not working properly after last update.
684
685
686## [4.9.14] - 2020-04-13
687
688### Added
689- Global options setting added `am4core.options.animationsEnabled` (default `true`). Set it to `false` to **disable all animations on all charts**. Can be used to toggle animations on and off dynamically.
690- `SliceGrouper` plugin: new setting `limit` added. If set to a number, will ignore `threshold` but will show only first X slices and will group the rest.
691- New PDF format option for `Export`: `align`. Available options: `"left"` (default), `"center"`, and `"right"`.
692- New `ValueAxis` property: `adjustLabelPrecision` (default: `true`). `true` means that **all** labels on `ValueAxis` (except zero) will maintain the same number of decimals, e.g. `1.0`, `1.5`, `2.0` versus `1`, `1.5`, `2`. Enabling it will ignore number of active decimals set via `numberFormat`.
693- `DateFormatter` is now exposing list of various named time units: `months`, `monthsShort`, `weekdays`, and `weekdaysShort`. You can now resolve numeric value to an English name (e.g. `chart.dateFormatter.weekdaysShort[2]`) or to your active locale (`chart.dateFormatter.language.translate(chart.dateFormatter.weekdaysShort[1])`).
694
695### Changed
696- New property `adjustLabelPrecision` hsa a default of `true`, which means that all labels will now have same number of decimals on `ValueAxis`. Set `adjustLabelPrecision = false`, to disable and revert behavior to how it was before this update (`1`, `1.5`, `2`).
697- `am4core.options.viewportTarget` now accepts array of references if you have multiple scrollable containers holding charts and have `onlyShowOnViewport` enabled.
698- Default `DateAxis.periodChangeDateFormats` for `"hour"` changed from `"_date_hour"` to `"_date_day"` so that the format would differ for midnight (hour 00:00).
699
700### Fixed
701- Parsing short month names (`"MMM"`) from string-based dates was failing on May.
702- When exporting chart to PDF, on narrow charts, sometimes the whole chart would go to the next page.
703- Having `null` values in data was causing `maxTooltipDistance == -1` to show multiple tooltips instead of one.
704- It was impossible to have individual `innerRadius` for `AxisRendererRadial` and `AxisRendererCircular` - the `RadarChart`'s `innerRadius` was overriding them.
705- Removing axis ranges from an axis could result in a JS error.
706- In some cases, when `DateAxis` properties `startLocation` and `endLocation` were not defaults (0 and 1), the chart might flicker from one grouped data period to another continously. It was only happening with some particular `groupCount` values and data item counts, though.
707
708
709## [4.9.13] - 2020-04-05
710
711### Added
712- Global options setting added `am4core.options.suppressErrors` (default `false`). Set it to `true` to disable error-invoked modal display.
713
714### Fixed
715- Setting `locale` as string (e.g. `locale: "fr_FR"`) in JSON config was not working.
716- `ValueAxis.min` and `ValueAxis.max` now accept `undefined`.
717- `NumberFormatter` and `DateFormatter` will not longer critically fail if invalid `Intl` data is passed to them. Instead they will return `"Invalid"` string.
718- Responsive: Sometimes objects were being revealed after coming back from responsive mode when thet shouldn't.
719- `locations` setting of the `SeriesDataItem` were not being copied to grouped data items (when `DateAxis.groupData = true`).
720- Shadow DOM: Made some changes to eliminate errors in IE11.
721- Shadow DOM: `ExportMenu` and `Popup`/`Modal` CSS was not being properly applied causing those elements to lose styling and positioning.
722
723
724## [4.9.12] - 2020-03-26
725
726### Added
727- New mouse cursor style added: `am4core.MouseCursorStyle.text`.
728- Export `formatOptions` now accessible via public property, e.g. `chart.exporting.formatOptions.getKey("csv").disabled = true`.
729
730### Changed
731- Using date format `"i"` to parse ISO dates now supports unlimited number of milliseconds. It was failing before if more than three digits were used for milliseconds.
732
733### Fixed
734- If `Label` had its interactions disabled then re-enabled, its `selectable` property was being ignored.
735- `Modal` with `closable = false` could still be closed via curtain click.
736- `openModal()` ignored title (second parameter).
737- Pushing child elements in `Label` which has `textValign` set was resulting in error.
738- `cursor.snapToSeries` was not working properly with `CategoryAxis`.
739- Firefox was not measuring labels properly if a chart was lazy-loaded using `onlyShowOnViewport`.
740
741
742## [4.9.11] - 2020-03-24
743
744### Added
745- Export: Added `disabled` property to all format options so you can disable each particular export format easily, e.g.: `chart.exporting.getFormatOptions("csv").disabled = true`.
746- New property on all `Sprite` elements: `userClassName`. If set, will also set element's `class` accordingly. Works directly, and via `propertyFields`.
747
748### Fixed
749- Fixed error with Angular Server Side Rendering (Angular Universal).
750- Accessibility: minor role issue fixed for items in `ExportMenu`.
751- It was impossible to change heat rule's min and max values after the rule was added.
752- Changing category of axisRange after it was alrady added to axis was not working.
753
754
755## [4.9.10] - 2020-03-19
756
757## Added
758- `SwitchButton` class added.
759- `width` field and adapter added to `ColumnSeriesDataItem`. Allows having variable column width via data binding.
760
761
762## [4.9.9] - 2020-03-16
763
764### Fixed
765- Fixed again: if chart had stacked axes and series with bullets, the bullets were not masked properly. Now you can set `series.maskBullets = true` to solve this.
766- `TimeLine` series bullets were not updating position when Y axis was zoomed.
767- Tooltips of `TimeLine`/`RadarChart` series were hidden on some parts of the chart (sice 4.9.7).
768
769
770## [4.9.8] - 2020-03-14
771
772### Fixed
773- Bullets on `RadarChart` were being masked incorrectly (since 4.9.7).
774- Background on `TimeLine` axis could be filled incorrectly in some cases (since 4.9.7).
775- `TimeLine` could error out in some cases (since 4.9.7).
776
777
778## [4.9.7] - 2020-03-14
779
780### Added
781- Export has now additional setting `dataFieldsOrder`. It's an array. Push field names into it and exported data will try to maintain field order like this.
782- A read-only property `tooltipDate` added to `DateAxis`. Will holde `Date` object of the last shown axis tooltip.
783
784### Fixed
785- In charts with series loading their own external data with responsive features enabled, they were starting as pre-hidden.
786- Axes in `XYChartScrollbar` (both value and date) were not reseting min/max if series of the chart changed. This could result scrollbar's series incorrectly displayed.
787- `PyramidSeries` and `FunnelSeries` with very small values were not animating properly on chart init.
788- `PyramidSeries` and `FunnelSeries` with data items with `value = 0` could show small rectangle at top/left corner.
789- `PyramidSeries` with data items with `value = 0` was not rendered properly.
790- Tooltip on a horizontal axis was "shaking" when cursor was very near plot area.
791- Performance improved of adding series to an already build `XYChart`.
792- Map was not drawn with certain initial `deltaLongitude` values (e.g. 30, 60, etc).
793- Removing series with a lot of data, `DateAxis` with grouping enabled, and zoomed-in chart could cause a stack overflow.
794- Removing series could cause error (if removed while initial animation was still playing out).
795- Sometimes, if a series was added after chart was inited and data grouping of `DateAxis` was enabled, the `ValueAxis` was not fully zoomed out.
796- A newly added series after the chart was inited was not showing initial animation.
797- Violating logarithmic axis scale no longer results in critical / chart-stopping error. The modal can be closed and chart recovered.
798- If chart had stacked axes and series with bullets, the bullets were not masked properly. Now you can set `series.maskBullets = true` to solve this.
799- Series tooltip is no longer shown if data item is outside plot area.
800- Perfectly straight line series in `XYChartScrollbar` were not displayed.
801
802
803## [4.9.6] - 2020-03-05
804
805### Changed
806- Setting `maxTooltipDistance` to `-1` on `XYCursor` will force only one tooltip to always be displayed, even if there are multiple data items in exact same spot.
807
808### Fixed
809- Responsive: changing data on a chart with active responsive rules was causing for those rules not to be re-applied when chart was updated.
810- If Legend item was clicked or tapped, subsequently pressing ENTER anywhere on the page was toggling it.
811- Series of `MapChart` and their children were inherinting main locale.
812- `ExportMenu` was freezing the whole chart is hovered (since `4.9.5`).
813
814
815## [4.9.5] - 2020-03-03
816
817### Added
818- Third paramterer - `force` - added to `ChartCursor.triggerMove`. If set to `true` it will trigger all actions associated with the move even if the cursor is already at the same coordinates.
819
820### Fixed
821- Exporting from ExportMenu will now prevent cursor (and releated tooltips) from appearing just before export so they are not included in exported image.
822- Panning on a `MapChart` with `panBehavior = "rotateLongLat"` was not working properly since `4.9.3`.
823- Disposed series was not being properly removed from `XYChartScrollbar` if it was used there.
824- Sprites with `dx`/`dy` set and `rotation != 0` were not displaying fixed-position tooltip in correct position.
825- Changing `tooltipText` was causing the tooltip to hide if it was already visible and `tooltipPosition` was set to `"pointer"`.
826- `XYChart` with legend positioned to right/left was not positioning `valueLabels` properly (if aligned to right).
827- `TreeMap` legend was not functioning properly.
828
829
830## [4.9.4] - 2020-02-26
831
832### Fixed
833- `MapChart` was erroring out if `homeGeoPoint` was set.
834- Bullets hovered by `XYCursor` were not being reset back if cursor left plot area.
835
836
837## [4.9.3] - 2020-02-25
838
839### Changed
840- `MapChart` will not perform its pan behavior (e.g. drag) if some other interactive element is being currently dragged. Good if you have a Scrollbar on top of the map for example.
841
842### Fixed
843- Fixed issue with `snapToSeries`.
844
845
846## [4.9.2] - 2020-02-25
847
848### Added
849- Accessibility: New method for chart's `svgContainer`: `readereAlert(text)`. When called, will force screen reader to read out certain text.
850- `velocityDecay` added to `ForceDirectedSeries`. Increase the number to slow down node dynamics.
851
852### Changed
853- Accessibility: If screen reader is enabled, it will notify user when a) legend item is triggered; b) `MapChart` zoom level changes.
854- `XYCursor.snapToSeries` now accepts an array of series and will snap to most close data point from any series present in the array.
855
856### Fixed
857- Now charts will properly disengage dragged elements when mouse cursor leaves iframe.
858- Fixed a typos in French, Portuguese translations.
859- Added more translated prompts to Korean translation.
860- When series which was being used in an `XYChartScrollbar` local data was being updated, the clone used in Scrollbar was not being updated.
861- `Series.autoDispose` setting was being ignored.
862- Fixed "The precision is out of range" errors on some browsers (Safari, IE) when very small numbers are used.
863- Accessibility: Setting of `tabindex` value was basically not working.
864- Funnel slice with `null` values showed small black rectangle at the top/left corner and legend item was not showing a marker.
865- Syncing between multiple `ValueAxis` improved.
866
867
868## [4.9.1] - 2020-02-14
869
870### Added
871- `precision` added to `MapLine` (default `0.1`). If line has `shortestDistance = true` set, it will be bent according to to projection. If `precision` is larger than the distance (degrees) between line's end points, no such bending will occur. Set it to large number for perfectly straight lines.
872- `precision` added to `MapPolygon` (default `0.5`). Polygon's side lines are bent according to to projection. If `precision` is larger than the distance (degrees) between side's end points, no such bending will occur. Set it to large number for perfectly straight lines.
873
874### Fixed
875- JSON config: referring to a `parent` by id is now not dependent on order of elements.
876- Series elements (e.g. columns) were not dispatching "over" event when `XYCursor` was being used.
877- When `Legend` was triggering hover over `PieSeries` slice (or other `PercentSeries`), the slice did not dispatch `"over"` event.
878- Hidden `ForceDirectedNode` (if hidden using API) was not showing if legend item was clicked to show it again.
879- `path` adapter was not working on `Sprite`.
880- Adding `data` to a `XYChart` with an `XYChartScrollbar` with a series was sometimes resulting JS error (if some data was missing).
881- Adding `AxisBreak` to `CategoryAxis` could result JS error.
882- `groupFields` were not copied to series in `XYChartScrollbar`, or any other cloned series.
883- If a bullet was already disabled when `disabled` property field was set, that bullet did not update correctly after data change.
884
885
886## [4.9.0] - 2020-02-09
887
888### Added
889- New plugin: [Venn Diagram](https://www.amcharts.com/docs/v4/chart-types/venn/).
890- `ForceDirectedSeries.dragFixedNodes` property added (default `false`).
891- `ForceDirectedSeriesDataItem.percent` getter added.
892
893### Fixed
894- Mouse interactions were not working properly in very old (pre-59) FireFox.
895- Dynamically changing `ForceDirectedSeriesDataItem.fixed` was not working.
896- `CirclePattern` was not being globally exported.
897- Setting `expoirtable = false` on some elements that are invisible sometimes caused them to become visible after export.
898
899
900## [4.8.9] - 2020-02-07
901
902### Added
903- Scrollbar.isBusy getter added, which is true when user interacts with Scrollbar.
904- RadarColumnSeries now support two category axes.
905- angleToPosition(angle) added to AxisRendererCircular.
906- currentPosition getter added to ClockHand.
907
908### Fixed
909- Export on IE (and other setups with `simplifiedExport = false`) was broken since upgrading canvg version.
910- When DateAxis had grouped set to true, in some cases the value axis was zoomed incorrectly after Data update.
911- In some specific cases XYScrollbar with series could produce JS error when adding data to the chart.
912- Funnel Series sliceLink could loose it's color after data update.
913
914
915## [4.8.8] - 2020-02-05
916
917### Fixed
918- When zooming `CategoryAxis` with sorted columns, some columns were not being displayed.
919
920
921## [4.8.7] - 2020-02-05
922
923### Added
924- `sortBySeries` property added to `CategoryAxis`. If you set it to an instance of a `ColumnSeries`, the axis will automatically sort its categories by actual series' values.
925
926### Fixed
927- Labels with extra line breaks at the end could sometimes inherit content from previous version of multi-text, e.g. in dynamically updated tooltips.
928
929
930## [4.8.6] - 2020-01-31
931
932### Fixed
933- Tree map with data items with value = 0 resulted error
934- ZoomToDates of DateAxis with grouped data was not always working properly.
935- colors ColorSet of PercentSeries were not cloneed when clonging series so clonned series used single Colorset which resulted different colors.
936- dateAxis.timezoneOffset was not working properly with value 0. Default value changed from 0 to undefined.
937
938### Added
939cloneTooltip flag (default value true) added to Sprite. When cloning a sprite, if the template has it's own tooltip assigned, this tooltip is also cloned by default. This is not good
940for cpu and sometimes you might only need one single tooltip for all clones. Set cloneTooltip to false in order not to clone tooltip.
941
942
943## [4.8.5] - 2020-01-29
944
945### Fixed
946- Reverted old behavior of DateFormatter.timezoneOffset, because the fix introduced in 4.8.3 was not correct. Use dateAxis.timezoneOffset instead.
947- it was possible to make fixed only nodes of the first level of ForceDirectedSeries.
948- when series is added/removed to a Serial chart, it adds/removes items only the specific item to/from the legend (if available), previously it used to invalidate entire legend which was not good for performance.
949
950### Added
951- timezoneOffset property added to DateAxis. Us it instead of DateFormatter.timezoneOffset if your dates are timestamps in your data and you want the chart to display the same dates no matter at which timezone the chart viewer is.
952
953- If `ValueAxis` has its `calculateTotals = true` set, the axis will calculate not only `total` and `totalPercent` for related series' data items but also `sum` which is mathematical sum of source the values, rather than their absolute values.
954
955
956## [4.8.4] - 2020-01-25
957
958### Fixed
959- Downgraded to TypeScript 3.6 to avoid the [breaking change](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-3-7.html#class-field-mitigations) in troduced in TS 3.7.
960
961
962## [4.8.3] - 2020-01-24
963
964### Added
965- New `ValueAxis` setting: `extraTooltipPrecision`. Set it to a number of extra decimal places to use for numbers in axis tooltip on top of current axis label precision. Default is `0`.
966
967### Fixed
968- Syncing of `ValueAxis` grid improved.
969- Using `timezoneOffset` was incorrectly affecting labels of `DateAxis`.
970- If `MapChart` was initialized in a hidden container, subsequent `zoomToMapObject()` calls were zooming incorrectly.
971
972
973## [4.8.2] - 2020-01-23
974
975### Added
976- `TreeMap.homeDataItem` getter added.
977
978### Fixed
979- Sometimes labels were not being truncated properly.
980- `ValueAxis` with values <1 might not display labels (since `4.8.1` only).
981- Axis syncing was not working on initial view if no animated theme was used.
982- Sometimes undefined variables were being restored with default state where they shouldn't. This was introduced in `4.8.1`.
983
984
985## [4.8.1] - 2020-01-22
986
987### Added
988- New setting `syncWithAxis` added to `ValueAxis`. Use it to sync grid between two or more axes. Set it to a reference of another `ValueAxis`, the one you need to sync grid with. [More info](https://www.amcharts.com/docs/v4/concepts/axes/value-axis/#Synchronizing_grid).
989
990### Changed
991- When default state is restored it will not set properties with `undefined` values as well. It used to ignore those.
992- `XYCursor` will now take its `behavior` logic into account when calculating if it has moved or not. For example, if `behavior == "zoomX"` it will only measure horizontal distance when determining if cursor has moved or not.
993
994### Fixed
995- `Annotation` plugin: setting `currentTool` property was not working for `"line"` and `"arrow"`.
996- Sometimes element properties were not being restored to their original values when responsive rules were applied.
997- Sometimes some bullets on a `TreeMap` were not being shown back on after drilling bacup to top level.
998- Setting `fontSize` on a `ValueAxis` was resulting in an error.
999
1000
1001## [4.8.0] - 2020-01-16
1002
1003### Added
1004- `scrollable` (default: `false`) property added to `Legend`. If the legend is positioned left/right and items do not fit in the available height, the scrollbar will appear automatically. In case legend is positioned at the top/bottom, you must set `maxHeight` for the legend and if items do not fit in this height, the scrollbar will appear.
1005- `Annotation` plugin: added new property `useMenu`. If set to `false`, plugin will not add any items to or create export menu. It means that annotation functionality will be available only via its API.
1006- `Annotation` plugin: added arrow tool support.
1007
1008### Changed
1009- Layout algorithm of `Legend`'s' item changed and made better. Labels are properly truncated if they do not fit. Alignment of value works fine.
1010- When `Legend`'s position is `"left"` or `"right"` it no longer fixes its width at 200px width, but sets `maxWidth` to 220. This means that legend will take only as much width as it is necessary to accommodate its contents, which usually results in more space for chart itself. Set `maxWidth` to `undefined` if you want all the labels to be displayed and not to be truncated if they don't fit.
1011- When `Legend`'s position is `"left"` or `"right"` it automatically sets `maxColumns` to `1` (one) so that legend items would be arranged in one column only. You can change this setting if you need more columns (you should do this after the position is set).
1012- Setting `focusable = true` on an element will now automatically set `tabindex = 0`. This is required for some browsers (FF) for elements to be focusable. This means that a bunch of elements that are focusable by default (legend items, grips, buttons, etc.) will now have `tabindex` set automatically as well.
1013- Default for `Label.ellipsis` (used when truncating texts) was changed from "..." (three dots) to "…" (
1014Unicode Character 'HORIZONTAL ELLIPSIS'; U+2026).
1015- `Label` wrapping will now try not to split strings on dots where there are no whitespace afterwards, e.g. "55.5%".
1016
1017### Fixed
1018- Axis fills were not measured properly after chart was resized and this could result in a tooltip to be displayed in an incorrect position.
1019- `valueLabels` of a `Legend` were not displayed if set directly on `valueLabels.template.text`. They were dispalyed only if set on `series.legendSettings.itemValueText`.
1020
1021
1022## [4.7.21] - 2020-01-10
1023
1024### Added
1025- `updateStacking()` method added to `XYSeries`. Must be called if some stacking properties are changed by `stacked` stays at `true`.
1026- `"hidden"` added to `SunburstChart`'s `dataFields` to enable pre-hiding certain slices.
1027
1028### Fixed
1029- Disabled series' legend marker was being reset to default view if related series visual settings changed.
1030- Changing data on chart with hidden stacked series was resulting in incorrect stacking.
1031- `XYChart` was not updating value axis' `min`/`max` if series was removed.
1032- If a cursor was moved via API using `"hard"` sticking option, the cursor could animate to some wrong position if clicked outside plot area.
1033- Animating from `Percent` to number or vice versa was not working at all, e.g. when state was being applied. It will now just flip to the final value without animation.
1034
1035
1036## [4.7.20] - 2020-01-08
1037
1038### Fixed
1039- Changing data for a chart with `DateAxis` and `groupData = true` and custom `baseInterval` was resulting the grouping not to working.
1040- Changing colors and some other visual properties of a series after the chart was inited was not affecting `LineSeries` and `ColumnSeries`, as well as their legend markers.
1041- Sometimes the active tooltip of the chart was hidden even though it should remain visible (if some other sprite was hidden at the moment).
1042
1043
1044## [4.7.19] - 2020-01-07
1045
1046### Added
1047- `Annotation` plugin: Added experimental setting `autoSize` (default: `false`). If set to `true`, it will try to relocated annotations relatively to chart size when it changes.
1048
1049### Fixed
1050- Changing `fill`/`stroke` property with a `Color` with non-integer alpha was resulting in either fully opaque or fully transparent color.
1051- Sometimes ordering of columns of `ColumnSeries3D` was off.
1052- `XYSeries` on super-wide/tall charts (more than 100K pixels) were being distorted.
1053- `Regression` plugin: Updating data directly for regression series was not being properly invalidating it.
1054- Toggling `groupData` on `DateAxis` from initial `false` to `true` after the chart was inited was not working.
1055- Toggling `groupData` on `DateAxis` from initial `false` to `true` was resulting in icorrect `ValueAxis` scale.
1056- A tooltip used to remain visible after disposing sprite, if it had a tooltip shown because of `alwaysShowTooltip = true`.
1057- Events `datavalidated` and `beforedatavalidated` were not being fired if data was being updated to an empty array.
1058- Toggling `stacked` from `true` to `false` on `XYSeries` was not working properly.
1059- `Component.removeData()` was causing all the data to be invalidated which caused some wrong behavior.
1060- If some format changed (number formatter) you must now call `invalidateLabels()` in order for the new format to be applied.
1061- `DurationAxis` now animates newly added data in the same way as `DateAxis` does.
1062- Adding/removing multiple series at once to/from `XYChartScrollbar` could result error.
1063
1064
1065## [4.7.18] - 2019-12-24
1066
1067### Added
1068- New property `maxTooltipDistance` added to `XYCursor`. Set it to a numeric value to limit display of tooltips from closest series only.
1069
1070### Fixed
1071- Tooltips were not displayed on non-measured sprites.
1072
1073
1074## [4.7.17] - 2019-12-22
1075
1076### Added
1077- `maskBullets` added to `XYSeries` for a possibility to set it on individual series rather on all chart.
1078
1079### Changed
1080- Changed `am4core.type.is` to `am4core.is`. This fixes a circular dependency issue.
1081- `centerMapOnZoomOut` of `MapChart` will kick in on `zoomLevel < 1.5` for a better UX.
1082
1083### Fixed
1084- Mouse wheel behavior on `XYChart` improved.
1085- Stacked series of a chart with multiple `ValueAxis` were not properly sorted.
1086- Some issues with hiding tooltips while chart is zooming fixed.
1087- Chart with rotated axis labels of Y axis could go into SO in some rare cases.
1088- `SankeyDiagram` with a single level and animated theme was not displaying links.
1089- Some min/max issues with grouped data on `DateAxis` fixed.
1090
1091
1092## [4.7.16] - 2019-12-18
1093
1094### Added
1095- `hideTooltipWhileZooming` (default `true`) property added to `XYSeries` and `Axis`. It will hide respective tooltips while chart zoom animation is playing.
1096- `customValue` data field added to `XYSeries`. Useful if you want to show (in a tooltip for example) some custom value when data is grouped and you need an aggregated numeric value that is not other than one of the Series' data fields.
1097- All the custom fields from chart's raw data are copied into grouped data item's `dataContext`. This allows referencing to custom fields via text placeholders even in aggregate data items when data grouping is enabled.
1098
1099### Changed
1100- Accessibility: Default `role` for chart changed to `region`.
1101
1102### Fixed
1103- Accessibility: `Scrollbar` and its elements now set required attributes like `aria-orientation`, `aria-controls`, `aria-valuenow`, `aria-valuetext`, `aria-valuemin`, and `aria-valuemax`.
1104- Annotation plugin: The elements that went outside of the chart area were not being properly clipped.
1105- `XYChartScrollbar` was not inheriting locale from parent chart.
1106- Sometimes grid lines (and some other lines) were blurry.
1107- Tooltips of an `XYChart` with stacked axes could be positioned incorrectly.
1108
1109
1110## [4.7.15] - 2019-12-16
1111
1112### Added
1113- `notAllowed` added to [`MouseCursorStyle`](https://www.amcharts.com/docs/v4/reference/mousecursorstyle/).
1114- `PieSeries`, `FunnelSerries`, `PyramidSeries`, and `PictorialStackedSeries` will now use absolute values for their slices (good if you have negative values).
1115- [`positionToCoordinate()`](https://www.amcharts.com/docs/v4/reference/axis/#positionToCoordinate_method) method added to `Axis`.
1116- Added `index` as second parameter to [`List.each()`](https://www.amcharts.com/docs/v4/reference/list/#each_method) method.
1117- `min` and `max` adapters added to `ValueAxis`.
1118
1119### Changed
1120- Icons in `ExportMenu` now have `box-sizing: border-box` set in default CSS to make icons play nice(er) with external CSS.
1121- Popup now has a tiny strip on top of it which can be used to drag it (much like regular windows in your OS), instead of the whole body of popup being draggable.
1122- Popup will now use theme colors for backgrounds/text.
1123
1124### Fixed
1125- The `List.each` method was missing an `index` argument for the callback.
1126- Links and other interactive elements in popups are now clickable.
1127- Labels in `PieSeries` could sometimes overlap if animated theme was not used.
1128- `DateAxis` with `groupData = true` and `"average"` as group field was now shown properly if data had gaps.
1129- `AxisRendererRadial` (`RadarChart` uses it) was not paying attention to `tick.location` property.
1130
1131
1132## [4.7.14] - 2019-12-10
1133
1134### Fixed
1135- valueAxis could be shown zoomed-in if series were added later in some rare cases.
1136- strokeLinecap and strokeLinejoin was not copied to Legend markers from Series.
1137- Some charts were not displaying after css-element-queries dependency update, temporary downgraded css-element-queries.
1138- Sometimes if using imagesToConnect with MapLine of MapLineSeries, the lines were not drawn if the imagesToConnect was set initially and not after the series initialized.
1139
1140### Added
1141- A possibility to set individual startAngle and endAngle on Pie Series added.
1142- You can now use baseValue adapter on ValueAxis.
1143
1144## [4.7.13] - 2019-12-07
1145
1146### Fixed
1147- Since last release only - min and max were not updated when scrolling chart with CategoryAxis.
1148- Map could zoom to incorrect rectangle when using chart.zoomToRectangle() method.
1149- DateAxis with groupData = true could hide series when zoomed in (when using big count of baseInterval, a very rare scenario).
1150- Tooltips of stacked series could show up in incorrect order in FireFox.
1151- Horizontal cone series could cut off part of the cone.
1152- If series were prehidden initially and shown later, the min/max was not adjusted.
1153- Grid/fills of the axis set as above were in wrong positions on stacked axes charts.
1154- ForceDirectedSeries now behaves better when nodes are hidden.
1155- In some cases connect = false set on StepLineSeries resulted error.
1156- If zoom-out button was initially disabled and enabled later, it was not shown.
1157
1158### Added
1159- FunnelSeries ticks now will have horizontal part, consistent with PieSeries.
1160- heatLegend now supports reversedOrder = true.
1161- You can now set custom tooltipText on CategoryAxis.
1162
1163
1164## [4.7.12] - 2019-12-04
1165
1166### Fixed
1167- Export menu was still shown data download options for HTML and PDF even if chart had no data.
1168- 3D columns with horizontally or vertically stacked axes were not positioned properly.
1169- Setting tooltipText on MapLine resulted stack overflow when hovered over line.
1170- Force-directed links were not showing tooltips.
1171- coordinateToPosition of AxisRendererY was not working properly if axis was zoomed-in.
1172- Value axes of a XY chart might appear zoomed-in after chart.invalidateData() was called or after series were added to the chart after init.
1173
1174### Added
1175- horizontalMouseWheelBehavior with options "zoomX" | "zoomY" | "zoomXY" | "panX" | "panY" | "panXY" | "none" added to XYChart. Will work with both horizontal scrollers (if available) and two finger-horizontal swipe on the touchpad.
1176- centerMapOnZoomOut added to MapChart, with default value true.
1177
1178
1179## [4.7.11] - 2019-11-26
1180
1181### Fixed
1182- Visual glitch with `ColumnSeries3D` used in a stacked axis scenario fixed.
1183- `PercentSeries` was sometimes jumping over 2 colors in `ColorSet`.
1184- Fixed possible compilation issues with some configurations.
1185
1186
1187## [4.7.10] - 2019-11-15
1188
1189### Added
1190- Global method `am4core.system.softInvalidate(chart)` added. Call this method if you update data or config of a chart that is in hidden container, after revealing the container, so that labels and possibly other elements can correctly arrange themselves.
1191
1192### Fixed
1193- JSON config `MapChart` was breaking on geodata parsing since last release (4.7.9).
1194- Sometimes `MapChart` used to zoom to a wrong position when using `zoomToMapObject()` method (happened if pan inert animation was not finished at the moment of the function call).
1195- `Container`'s "grid" layout was incorrectly positioning items if one of its children was disabled.
1196- Creating a standalone series object (without assigning it to a chart) was resultin in a JS error.
1197
1198
1199## [4.7.9] - 2019-11-14
1200
1201### Added
1202- New `Sprite` property: `showTooltipOn`. Available options: `"hover"` (default), `"hit"`, and `"always"`.
1203- `ignoreZeroValues` added to `PercentSeries` (default: `false`). If set to `true` it will not show slices with zero values.
1204
1205### Changed
1206- `Sprite` property `alwaysShowTooltip` is now being deprecated in favor of `showTooltipOn = "always"`.
1207- In `WordCloud` words connected with a dash without spaces will not be treated as a single word, e.g. "76-ers" is now a single word rather than two separate words "76" and "ers".
1208- JSON config based charts will now fail with a critical error if there's incorrect `type` specified for one of the objects.
1209
1210### Fixed
1211- Initial chart responsive rules were sometimes not being applied.
1212- When `MapChart` was zoomed/panned, "always-on" tooltip were remaining in the same place.
1213- HTML labels with `maxWidth` and `wrap` set were not being sized correctly.
1214- Sides of `Column3D` were not being colored properly when `fill` was being set via `propertyFields` and string-based hex color codes were used in data.
1215- After click on chart with `XYCursor` that `behavior = "select*"` its `xRange` and `yRange` was not being reset and could show ranges from previous selection.
1216- `XYCursor` will now respect order of series when showing their tooltips if they share the same value.
1217- Tooltip position of rotated and/or scaled sprites was incorrect.
1218- Changing series of `XYChartScrollbar` was not working properly (old series could remain or new series were not appearing).
1219- `PictorialSeries`, and `PyramidSeries` were not working properly with slices with `<= 0` values.
1220- When removing data from a chart using `addData(data, removeCount)`, chart was rmeoving data items from series which had data set explicitly.
1221- Bullets on a `RadarChart` could be displayed in wrong positions when zooming/hiding series.
1222- When minimizing series they could animate to incorrect minimum values and adjust min/max values.
1223
1224
1225## [4.7.8] - 2019-11-05
1226
1227### Added
1228- `itemIndex` added to `AxisDataItem`. Shows current index of data item on the axis.
1229
1230### Changed
1231- `extremeschanged` is now dispatched by `DateAxis` when the `min`/`max` are animating.
1232
1233### Fixed
1234- Setting `maskBullets` on an `XYChart` will toggle on or off bullet masking dynamically.
1235- In some particular cases some Sankey nodes were drawn out of bounds.
1236- `behaviorcanceled` event of `ChartCursor` was not being fired.
1237- Regression plugin was failing when added to Series object that was not yet attached to a Chart.
1238- JSON config was failing where Label's `text` or `html` properties were being set to percent value.
1239- Toggling of `DateAxis.skipEmptyPeriods` was not working after the chart was already inited.
1240
1241
1242## [4.7.7] - 2019-11-02
1243
1244### Added
1245- `NumberFormatter` now supports `numberFormat` in [Intl.DateTimeFormatOptions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat) objects. E.g. `chart.numberFormatter.numberFormat = { style: "decimal", minimumFractionDigits: 3 }`. [More info](https://www.amcharts.com/docs/v4/tutorials/formatting-date-time-and-numbers-using-intl-object/).
1246- New built-in pattern: `CirclePattern`.
1247- `PictorialStackedSeries` now supports `align`/`valign` settings, allowing controlling its position inside chart container.
1248
1249### Changed
1250- Default pattern list in `PatternSet` is expanded and revamped for better look and increased contrast.
1251- Pattern elements are now centered, so they work better with `rotation`.
1252- `MapChart` now will shift zoom towards center gradually when zooming out.
1253
1254### Fixed
1255- `getIndex()` method of `PatternSet` was always returning current pattern, not particular index.
1256- Sometimes Export's user-added `"data"` adapter was kicking in before amCharts built-in adapter, causing data edits to be overwritten.
1257- Built-in adapters (e.g. for export `"data"`) sometimes were being added multiple times.
1258- Export no longer errors out on pages with missing external CSS files.
1259- Using `addData()` on `PercentChart` was reusing colors from the beginning for the newly added slices.
1260- `SliceGrouped` on `PercentSeries` when used on a chart with responsive fetures enabled, could display labels of the hidden slices after chart resize.
1261- Issue with zooming `DateAxis` with single data item fixed (the single item used to disappear in certain cases).
1262
1263
1264## [4.7.6] - 2019-10-29
1265
1266### Added
1267- Added more pre-set patterns to `PatternSet`, including one with circles.
1268
1269### Changed
1270- Using `patterns` theme will no longer reset Series' colors.
1271- Using `patterns` theme now respects series' `fillOpacity` setting to set pattern background transparency.
1272
1273### Fixed
1274- Formatted strings were being cut off at specific `\]]` character combination.
1275- `LineSeries` with `RectPattern` for a fill was failing on chart with a legend.
1276
1277
1278## [4.7.5] - 2019-10-26
1279
1280### Added
1281- New theme: `microchart`. Automatically adapts all charts for very small containers.
1282- New theme: `patterns`. Automatically fills `ColumnSeries` and `PercentSeries` with distinctive patterns.
1283- New object `PatternSet` used in conjunction with `XYChart` or `PercentSeries` to auto-assign distinctive pattern fills.
1284- New property `patterns` on `XYChart` and `PercentSeries`.
1285
1286### Changed
1287- `tooltipX` and `tooltipY` properties now can be set in `Percent` for relative positioning.
1288
1289### Fixed
1290- Cursor on all-`ValueAxis` setups and behavior set to "zoomXY" was not working properly.
1291
1292
1293## [4.7.4] - 2019-10-22
1294
1295## Added
1296- New global option: `am4core.options.viewportTarget`. If you are placing charts into a scrollable container and using `onlyShowOnViewport`, set this option to a reference to the container. The system will monitor both window and individual scroll of the container to know where to reveal the lazy-loaded chart.
1297- New `MapChart` property: `geodataNames`. It can now be used to automatically translate country names into multiple languages. Check out [usage instructions](https://www.amcharts.com/docs/v4/tutorials/using-map-country-name-translations/).
1298- `hideParentColumns` property added to `TreeMap`. If set to `true` columns of the parent series will be hidden when user drills-down into deeper levels.
1299
1300### Fixed
1301- `ColorSet` was starting to generate grayscale colors at some point.
1302- Accessibility: Series that has items with roles "menuitem" will now have its role set to "menu" automatically.
1303- Series bullets were dislocated on `XYChart` with `DateAxis` and `dateFormatter.utc = true`.
1304- In some specific cases 3D columns used incorrect `zIndex`.
1305- Index of dataItem of `PercentSeries` could be `-`1 after first render.
1306- `yRange` of `XYCursor` was inversed.
1307
1308
1309## [4.7.3] - 2019-10-18
1310
1311### Fixed
1312- `ColumnSeries` with `simplifiedProcessing = true` setting was sometimes producing visual glitches.
1313
1314
1315## [4.7.2] - 2019-10-18
1316
1317### Added
1318- `RadarColumn` now supports `width` adapter (the adapter should return `Percent` object).
1319
1320### Changed
1321- `minWidth`/`minHeight` set on Axis to 0.0001 to avoid ready event to be not called on super small divs.
1322
1323### Fixed
1324- A link between two fixed `ForcedDirectedTree` nodes was not visible.
1325- If `maxZoomCount` was set on a series which was used for `XYChartScrollbar`, scrollbar series was zoomed-in.
1326- `PercentChart`'s legend, if placed to an external div could loose text formatting after data update.
1327- `gridType = "polygons"` of `RadialAxis` was not working.
1328- Label of `PinBullet` was not being cloned.
1329- `rangeChangeEasing` function was not being passed to `ValueAxis` min/max animation which resulted in some unwanted animation effects when min/max of the axis changed.
1330
1331
1332## [4.7.1] - 2019-10-16
1333
1334### Added
1335- Two additional auto-calculated values (used in `valueXShow` and `valueYShow` data fields) added: `startChange` and `startChangePercent`. Shows change from starting value of the first data item in series.
1336
1337### Changed
1338- Animated theme: Default values for `rangeChangeDuration` and `interpolationDuration` changed to `500` (was `700`). Makes zooming animations more snappy.
1339
1340### Fixed
1341- Data item grouping was sometimes producing visual anomalies when multiple data sets were being loaded /set to chart/series asynchronously.
1342
1343
1344## [4.7.0] - 2019-10-14
1345
1346### Added
1347- Dynamic data item grouping capabilities added to `XYSeries` in `DateAxis` + `ValueAxis` setups. [More details](https://www.amcharts.com/docs/v4/concepts/axes/date-axis/#Dynamic_data_item_grouping).
1348- Export: Two new data export options "HTML" and "PDF" (exports data as a table in PDF).
1349- Export: Ability to include data table into PDF export (`addData` option in PDF options).
1350
1351### Fixed
1352- Regression plugin: Plugin was not generating proper regression lines if data was loaded via `dataSource`.
1353- Fixed number formatting for data exports on non-default-locale charts.
1354- `min`/`max` of `ValueAxis` was not always correct when series showed not actual but calculated values using `valueYShow`/`valueXShow` data fields like `"sum"`, `"change"`, or `"changePercent"`.
1355
1356
1357## [4.6.9] - 2019-10-08
1358
1359### Fixed
1360- Accessibility: `itemReaderText` on `XYSeries` (and all inheriting series types) now respects value set from user code.
1361- Accessibility: Default `role` for chart changed to `widget`.
1362- Accessibility: `Axis` has now `readerHidden = true` set by default, to prevent screen readers from reading out useless numbers.
1363- Accessibility: `readerTitle` was not being populated by data item data via curly bracket data placeholders.
1364- Accessibility: Bullets were ignoring Series' `skipFocusThreshold` setting.
1365
1366
1367## [4.6.8] - 2019-10-07
1368
1369### Added
1370- New `Export` property: [`validateSprites`](https://www.amcharts.com/docs/v4/reference/export/#validateSprites_property). It's an array you can push any `Sprite` to it. When export starts, it will check if those elements are not invalid and will await for them to be ready. This is useful if you need to do any modifications to your chart for export.
1371- New option for CSV and XSLX export options: `pivot`. If set to `true`, will "pivot" the data so that firsst column is field names with values lined up horizontally in rows.
1372- New property on `NumberFormatter`: `smallNumberThreshold` (default `1`). You can now set what is considered a "small number" when applying small number prefixes if `"a"` format modifier is used.
1373
1374### Fixed
1375- If `ForceDirectedTree` was used with `am4core.options.onlyShowOnViewport = true`, the forces on links were not being calculated properly, resulting in incorrect layout.
1376- JSON: String dates will now be correctly parsed using `DateFormatter` in axis ranges' `date` and `endDate` properties.
1377- `WordCloud` was not properly parsing Korean text.
1378- If `MapChart` was zoomed in while still playing pan inertia animation, it produced a jerky effect.
1379
1380
1381## [4.6.7] - 2019-10-05
1382
1383### Added
1384- `paddingRadius` added to `ForceDirectedNode`. Allows having some extra free space around bubbles.
1385- New event on all `Sprite` elements: `parentset`. Triggers whenever element's `parent` is set.
1386
1387### Fixed
1388- `MapChart` background was not being updated if map projection was changed after init.
1389- Axis' tooltip was not changed if user rolled over the axis, rolled out and then rolled over it again on the same axis item.
1390
1391
1392## [4.6.6] - 2019-10-04
1393
1394### Fixed
1395- Language setting was being ignored in `DateAxis` after previous release.
1396
1397
1398## [4.6.5] - 2019-10-02
1399
1400### Fixed
1401- Position of the bullets of a series with date-based axis could be incorrect in some sepecific cases.
1402- Some minor performance improvements.
1403- Map polygon was not updated if `mapPolygon.multiGeoPolygon` was changed after the series was already inited.
1404- Some minor issue with `XYCursor` panning fixed.
1405
1406
1407## [4.6.4] - 2019-09-29
1408
1409### Added
1410- Ukrainian translation (uk_UA).
1411- `DataSource` now supports binary loading using `responseType = "blob"`.
1412
1413### Fixed
1414- Setting `exporting.dateFormat` resulted in "Invalid date" as a column name for date/time columns when exporting to XLSX.
1415- Performance improved, especially data-parsing.
1416- When panning `XYChart`, the chart will round selections respecting `startLocation` and `endLocation` values of the Axis.
1417- First bullet of a series with `CategoryAxis` could be positioned incorrectly.
1418- Conflict between Annotation plugin and amCharts 3 Export plugin fixed.
1419
1420
1421## [4.6.3] - 2019-09-26
1422
1423### Fixed
1424- `ColorSet` was now skipping the first (base) color if no theme or list of colors was specified.
1425- Setting axis `title` to a new `Label` object will now remove the previous title label.
1426
1427
1428## [4.6.2] - 2019-09-25
1429
1430### Added
1431- New plugin: [OverlapBuster](https://www.amcharts.com/docs/v4/tutorials/plugin-overlap-buster/). Allows automatically "exploding" overlapping items such as bullets or markers for easier access to them.
1432- New property: `maxZoomCount` on `Component`. Use it to limit how many items such as categories or base intervals on axes can be shown at the same time.
1433- Added `riseFromOpenState`, `riseFromPreviousState`, `dropFromOpenState`, and `dropFromPreviousState` setters to `ColumnSeries`. You can use them to set states to `undefined` if you don't want them to be used.
1434- A possibility to make "fixed" `ForceDirectedTree` nodes added (via `dataFields.fixed`). Also it is possible to set `x` and `y` of such nodes using `series.nodes.template.propertyField.x` and `y`. [More info](https://www.amcharts.com/docs/v4/chart-types/force-directed/#Fixed_nodes).
1435
1436### Changed
1437- Removed "GIF" option from the Export menu. Browsers don't know how to convert canvas to GIF, so it was falling back to exporting as PNG, making GIF option redundant.
1438
1439### Fixed
1440- If chart's data source was initialized (which would happen by only accessing chart's `dataSource` property) and its `url` was not set, it was still trying to load and resulting in error.
1441- Formatting number with "b" modifier, was causing all numbers up to 1024 become zero.
1442- `ColorSet` with default (no) theme was generating colors from second in the list from `4.6.1`.
1443- Bullet positions were incorrect on `ValueAxis` with `baseValue` set to other than zero.
1444- Bullet positions with `DateAxis` could be incorrect in some cases.
1445- Title position of a cloned Axis was nor being positioned properly.
1446- Cursor was flickering if axis of a cursor had some padding set.
1447- Tooltip position of `MapImage` elements with `nonScaling = true` could be incorrect in some specific cases.
1448- Vertical axis break's fill might get out of sync with break lines if the width of a break was small.
1449- `RadarCursor` could show incorrect label if the chart had `CategoryAxis` with only 3 categories.
1450- Series was not redrawing properly if its axis range value changed.
1451- `PieChart` could show some labels out of chart area in some specific cases.
1452
1453
1454## [4.6.1] - 2019-09-18
1455
1456### Added
1457- New property `unselectedOverlay` added to `XYChartScrollbar`. It contains a reference to `Sprite` element used as a "curtain" on unselected areas of the scrollbar. Use it to control dimming effect by using its `fill` and `fillOpacity` properties.
1458- Export: New option `crop` (default: `false`) added to `extraSprices` interface `IExportCanvas`. If set to `true`, it will crop extra elements to match height/width of the main chart being exported.
1459- Wherever "date format" can be set it now accepts in [Intl.DateTimeFormatOptions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat) format. E.g. `chart.dateFormatter.dateFormat = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' }`.
1460- New property `intlLocales` on `DateFormatter`. Specifies list of locales to use if date formates are specified as `IntlDateTimeFormatOptions`.
1461- JSON: You can now set `parent` property of the elements by their `id` in JSON configs. E.g.: `scrollbarX: { parent: "aa1" }`.
1462- JSON: You can now set easing functions as strings in JSON config, e.g. `transitionEasing: "ease.cubicInOut"`.
1463
1464### Fixed
1465- `TreeMapSeries` and `SunburstSeries` were not inheriting `numberFormatter` propertly from the chart.
1466- Removed a leftover `console.log()` call.
1467- Exporting no longer temporarily modifies the site's styles.
1468
1469
1470## [4.6.0] - 2019-09-12
1471
1472### Added
1473- New plugin: [Timeline](https://www.amcharts.com/docs/v4/chart-types/timeline/). Please note it's a commercial plugin, which will need a separate license purchase if you want to remove the branding link on it, even if you have amCharts 4 license.
1474
1475### Fixed
1476- `chart.svgContainer.autoResize = false` was being ignored.
1477- If data of chart with `CategoryAxis` had data items without a category value, the chart used to create one extra empty "category".
1478
1479
1480## [4.5.16] - 2019-09-04
1481
1482### Fixed
1483- Data sources were not being disposed properly when chart was disposed.
1484- Adding series to an already inited chart was not showing the series.
1485- Fixed `StepLineSeries` glitch where base axis was not `CategoryAxis`/`DateAxis`.
1486- Title of a cloned X axis was being drawn above the axis labels.
1487- If all values of a `ValueAxis` data wehere the same and negative, the chart zoomed in incorrectly after init.
1488- Center-alignment of axis labels was not working.
1489- `maxWidth`/`maxHeight` set on column template of a `ColumnSeries` was not working properly if the size of a cell was less than `maxWidth`/`maxHeight`.
1490
1491
1492## [4.5.15] - 2019-08-23
1493
1494### Added
1495- `hideSeriesTooltipsOnSelection` added to `XYCursor`. If set to `true` it will automatically hide cursor-initiated series tooltips when selecting with cursor (e.g. for a zoom).
1496- Properties `numberFields`, `numberFormatter`, and `numberFormat` properties to `Export`. Allows forcing certain number format for values listed in `numberFields` effectively converting them into strings.
1497- `snapToSeries` now supports `XYChart` setups where both X and Y axes are `ValueAxis`.
1498
1499### Changed
1500- `ZoomControl`'s plus and minus button will not be exported to images anymore.
1501
1502### Fixed
1503- When the chart with external data source and reload frequency set was disposed, the data source kept reloading the data.
1504- When Tooltip's `keepTargetHover` was enabled and hover moved from an element with tooltip content to an element without one, an empty tooltip was being shown.
1505- `SankeySiagram` with a lot of nodes was performing poorly on initial load.
1506- `TreeMap` could show bullets of multiple levels which could result overapping of bullets/labels.
1507- `MapLineSeries` with `imagesToConnect` were not updating if images changed their positions.
1508
1509
1510## [4.5.14] - 2019-08-11
1511
1512### Added
1513- `mouseOptions` added to `Interactions`. For now it contains only wheel sensitivity setting, e.g. `mapChart.interactions.mouseOptions.sensitivity = 0.4`.
1514- `getPositionX()` and `getPositionY()` methods added to all axes. Returns relative position of a series data item on axis.
1515
1516### Changed
1517- Series with `DateAxis` not as a base axis of a series (like gantt) will now animate similar to other charts.
1518- `SlicedChart` hidden labels arrangements adjusted.
1519
1520### Fixed
1521- `ValueAxis` was incorrectly choosing min/max values for the data with very small values.
1522- `StepLineSeries` with `connect = false` and `autoGapCount > 1` was showing regular line series, not a step series.
1523- Chart with `DateAxis` which was not a base axis of a series and dates older than Unix Epoch (January 1st, 1970 at UTC) was incorrectly showing base of a series.
1524- `DateAxis` was not animating smoothly when adding more data.
1525- `ValueAxis` pre-zoom (on `ready` event) was not working properly.
1526- `fullWidth` cursor line was not reverting back if set to `true` and then back to `false`.
1527
1528
1529## [4.5.13] - 2019-08-06
1530
1531### Fixed
1532- Sometimes `requestAnimationFrame` was being invoked even if all charts were disposed.
1533- Base grid was not displayed if `axis.renderer.inside = true`.
1534- Last tooltip might not be shown on `DateAxis` if it had multiple series and some of the series did not have data at the last date.
1535- Legend values were showing value of the pervious hovered data item on the dates which did not have any data.
1536- Changing base value of `ValueAxis` was not making the series to be redrawn.
1537- Sometimes `ValueAxis` was not adjusting `min`/`max` when a part of the `DateAxis` with series having no data at the selected period was selected.
1538- Sometimes columns or step line series could overlap if `baseInterval.unit = "day"` and `baseInterval.count > 1`.
1539- `XYChartScrollbar` axes were not handling changes of `min`/`max` of chart axes.
1540- Panning of `CategoryAxis` could result incorrect zoom in some cases.
1541- FireFox issue with multiple `PictorialStackedSeries` on the same chart solved.
1542- Cursor selection was disappearing when mouse was released (with `selectX`/`selectY`/`selectXY` cursor behavior).
1543- Tooltip of clustered columns was positioned incorrectly (always showing in the middle of a cell).
1544
1545
1546## [4.5.12] - 2019-08-02
1547
1548### Added
1549- Now prints a warning if you do not dispose of the chart properly.
1550- New `am4core.disposeAllCharts` function.
1551
1552### Changed
1553- JSON: Config processor will not overwrite target object if the `type` of the object set in config and one already existing matches.
1554
1555### Fixed
1556- Fixing "Could not find root" error.
1557- JSON: declaring `hands` array before `axes` on a `GaugeChart` will not result in error anymore. This relates to JSON config only. In object-based setups, clock hands must still be defined **after** axes.
1558
1559
1560## [4.5.11] - 2019-07-31
1561
1562### Added
1563- New `AxisDataItem` properties: `minPosition` and `maxPosition`. Enable controlling visibility of associated axis element (e.g. label, tick, grid). Overrides `minLabelPosition` and `maxLabelPosition`.
1564
1565### Fixed
1566- `NumberFormatter` was sometimes susceptable to floating-point error when formatting percent formats (`#%`);
1567- Cursor hover was not working with shadow DOM.
1568- `DateFormatter` could sometimes parse string-based dates wrong when in UTC mode.
1569
1570
1571## [4.5.10] - 2019-07-29
1572
1573### Fixed
1574- Sometimes setting `fill`/`stroke` to a non-opaque `Color`, alpha setting was being ignored.
1575- `PinBullet` (from Bullets plugin) was distorted if used with image since last release.
1576- Fabric dependency was causing errors on installation under some setups.
1577
1578
1579## [4.5.9] - 2019-07-24
1580
1581### Added
1582- `above` property added to `AxisTick`, `Grid`, and `AxisFill`. Allows putting individual elements on top of the series even if all the other grids/ticks/axis fills are below them.
1583- `bullet` property added to `AxisDataItem`. Allows adding bullets to the axes. You can have both `AxisBullet` (new class) or a simple `Sprite` there.
1584- New element class `AxisBullet`. Use `AxisBullet` which is a container with a `location` property in case you want to adjust bullet location within cell.
1585
1586### Fixed
1587- JSON: Series-bound axis ranges were breaking whole chart in JSON-based setups.
1588- In some rare cases `NumberFormatter` was suffering from floating point number precision issue when calculating big number prefixes.
1589- Updating data was causing Annotation menu item to duplicate.
1590- Exporting `extraSprites` with different positions didn't work.
1591- Responsive rules were not always kicking in on first load if there were multiple charts on the same page.
1592
1593
1594## [4.5.8] - 2019-07-19
1595
1596### Added
1597- `wavedRight`, `wavedLeft`, `wavedTop`, and `wavedBottom` properties added to `WavedRectangle`. Allows to specify which sides of rectangle should be waved.
1598
1599### Changed
1600- You can now avoid creating unused bullet for each data item of a series by setting `bullet.disabled = true` and then specifying `bullet.propertyFields.disabled = "fieldName"` where `fieldName` would be a field in your data specifying which bullets should not be disabled (`false` value).
1601
1602### Fixed
1603- `FlagBullet` was overriding colors inside its class.
1604- `FlagBullet` now supports negative `poleHeight` (turns the flag upside down).
1605- Background of a `Container` did not have access to Container's data item so it was impossible to define background properties via `propertyFields`.
1606
1607
1608## [4.5.7] - 2019-07-18
1609
1610### Added
1611- New plugin: [Bullets](https://www.amcharts.com/docs/v4/tutorials/plugin-bullets/). It's a collection of configurable shapes (stars, pins, flags, etc.) that you can use as chart bullets, map markers, and anywhere else.
1612- New `Tooltip` property: `showInViewport` (default `false`). if set to `true` it will not hide tooltips that point to an off-viewport location. It will be glued to the closes viewport edge instead.
1613
1614### Changed
1615- Tooltip for `MapPolygonSeries` now has `showInViewport = true` set by default.
1616
1617### Fixed
1618- Exporting to CSV with `dateFormat` set was causing "Invalid date" to appear instead of date column names (since 4.5.6).
1619- When `MapPolygonSeries` had only one item set in its `include` array, it was causing map to come up as empty in some cases.
1620- Charts were not accounting for their container padding/borders when measuring their own size, causing bigger charts then necessary.
1621
1622
1623## [4.5.6] - 2019-07-16
1624
1625### Added
1626- New property on `Annotation` plugin: `data`. Allows getting serialized annotation data object, as well as setting it back to load annotations.
1627
1628### Changed
1629- Annotation plugin will not create full Export menu if it wasn't explicitly created before.
1630- Tweaked CSS for `ExportMenu` to protect from icons getting small becuase of the page-wide CSS.
1631- When exporting data on chart with `exporting.dateFormat` set, the date/time fields in data will be formatted according to the set format.
1632
1633### Fixed
1634- `XYChartScrollbar` with series attached to different `ValueAxis` were using same axis scale in the scrollbar.
1635- Using `wrap = true` on horizontal axis labels was resulting weird behavior when zooming in some cases.
1636- Export was not prioritizing menu item's specific options over generic format options.
1637- Auto-wrapped text was not retaining square bracket escaping (double bracket) for each subsequent line.
1638
1639
1640## [4.5.5] - 2019-07-12
1641
1642### Added
1643- New property `updateCurrentData` added to `DataSource`. If set to `true` it will try to overwrite values (resulting in smooth animations) in current data rather than overwriting whole data set.
1644- Feature added back: Support of queued chart initialization. If enabled (`am4core.options.queue = true`) the chart will not start initializing until previous chart finishes.
1645- Feature added back: Support for delayed rendering. If enabled (`am4core.options.onlyShowOnViewport = true`) the chart will start rendering itself only when scrolled into view.
1646- New plugin: [Annotation](https://www.amcharts.com/docs/v4/tutorials/plugin-annotation/). Allows annotating charts using UI.
1647
1648### Fixed
1649- Accessibility: The screen reader description for column/bullet/slice was not being added properly every time.
1650- On `RadarChart` data updates sometimes `ValueAxis` scale was not being calculated corrently.
1651- `alwaysShowTooltip` was not working properly in some cases.
1652
1653
1654## [4.5.4] - 2019-07-08
1655
1656### Added
1657- `alwaysShowTooltip` property added to `Sprite`. Allows tooltip to be shown without the need for hovering/selecting an element.
1658- `NumberFormatter` now supports `"!"` modifier which works in conjunction with `"a"` and `"b"` modifiers. If used, formatter will force application of a prefix/suffix for values that do not fit into any of the defined prefix lists. This is useful in cases you want to format all of the values using same prefix, e.g. "B" and want even small values to be formatted as such (`500,000` formatted as `"0.5B"`).
1659
1660### Fixed
1661- `CategoryAxis` tooltip could show incorrect category if its `renderer.tooltipLocation` was set to `0`.
1662- Memory leak which happened when disposing a chart with `XYChartScrollbar` with series added to it fixed.
1663- Some series stacking issues fixed.
1664- Issue with `baseDuration.timeUnit = "yyyy"` and `StepLineSeries` fixed.
1665- In some cases `DateAxis` tooltips would show empty near edge of the plot area.
1666- `CategoryAxis.indexToPosition` adjusted to work better with no default `startLocation` and `endLocation` values.
1667- `WordCloud` could go into stackoverflow if `minWordLenght` was set to a number which resulted in no words to appear at all.
1668- `ForceDirectedSeries` were resulting in JS error if inited in a hidden container.
1669- If an axis range was made invisible by setting its `visible = false`, and then visibility was set back to `true` again, axis range was not shown.
1670- JSON: entries of type `OrderedListTemplate` or `SortedListTemplate` was not being processed correctly as templated lists.
1671- Legend items were still focusable/togglable via keyboard even if `clickable`/`focusable` on their respective containers were set to to `false`.
1672
1673
1674## [4.5.3] - 2019-06-18
1675
1676### Added
1677- `"up"`, `"down"`, `"left"` and `"right"` options added to `Tooltip.pointerOrientation`. Allows forcing constant position/orientation of the Tooltip. Note, the tooltip might go out of div/screen boundaries when using these new orientations.
1678- New property added to `SliceGrouper`: `groupProperties`. It's an object comprising by key/value pairs to apply to a "group slice", e.g. `grouper.groupProperties.fill = am4core.color("red")`.
1679- It was impossible to reuse single pattern for multiple `Sprite` elements, as disposing one was resulting in pattern to be disposed as well.
1680
1681### Fixed
1682- `hideOversized` was being ignored for HTML-based labels.
1683- `PieChart` series' `legendSettings` were shared across all series; it was impossible to set different `valueText`.
1684- `CategoryAxis` with HTML labels could in result excessive white space at the bottom of the chart.
1685- In some cases patterns set as `Sprite`'s fills using `fill` adapter were not displayed.
1686- When calculating totals on a Series with all zero values, `percent` was not being calculated. It will now have a zero.
1687
1688
1689## [4.5.2] - 2019-06-14
1690
1691### Changed
1692- Deferred/queued chart initialization functionality is disabled completely for now as it's causing issues in some setups. Functionality will be re-introduced at some later version.
1693
1694
1695## [4.5.1] - 2019-06-14
1696
1697### Changed
1698- Initial animations for charts with deferred initialization (`am4core.options.onlyShowOnViewport = true`) will not be played for now. Another fix is coming.
1699
1700### Fixed
1701- In some HTML configurations layout of the labels might be off since last update.
1702
1703
1704## [4.5.0] - 2019-06-14
1705
1706### Added
1707- Support of queued chart initialization. If enabled (`am4core.options.queue = true`) the chart will not start initializing until previous chart finishes.
1708- Support for delayed rendering. If enabled (`am4core.options.onlyShowOnViewport = true`) the chart will start rendering itself only when scrolled into view.
1709
1710### Changed
1711- Default CSS for a `Popup` now has text color set to ensure it is visible on default background.
1712
1713### Fixed
1714- `dataContext` of `ForceDirectedNodeDataItem` was not being populated correctly.
1715- `MapPolygonSeries` was not being displayed properly if GeoJSON contained a single very small polygon.
1716- Tooltips now work correctly when a chart is contained within the shadow DOM.
1717- `rtl` inheritance was not working properly on some elements, e.g. axis tooltips.
1718- None of the `Responsive` events were being triggered.
1719- JSON: It was not possible to set `XYSeries.baseAxis` using axis' `id`.
1720- `LineSeries` was being cut off if div of a chart was more than 20K pixels width/height.
1721- When axis was disabled (`axis.disabled = true`) its ticks and grid remained visible.
1722- If a chart had series with bullets and `minBulletDistance` set and the chart was resized so that bullets had to be hidden, some of the bullets remained visible.
1723- `openCategoryX` and `openCategoryY` data fields were not working properly on `XYSeries`.
1724- If `XYChart` had stacked series and series had both possitive and negative numbers, series were stacked incorrectly if some of the series were hidden.
1725- `MapChart` was not adjusting its size to the container in some specific cases.
1726- Some performance improvements with `series.connect = false` and a lot of missing values.
1727- `Rectangle3D` was not copying side's properties when cloning.
1728- `ForceDirectedLink`'s data item was not properly set. It is set to target's data item now.
1729- `MapChart` was not displaying maps of very small countries properly.
1730
1731
1732## [4.4.10] - 2019-05-28
1733
1734### Fixed
1735- Disposing top-most stacked series was causing a JS error.
1736- If `TreeMap` top level had one node only, zoom-out button was not shown after drill-down.
1737- Bullets were not shown on series on initial render if no animated theme was used (since last release only).
1738
1739
1740## [4.4.9] - 2019-05-28
1741
1742### Added
1743- `startIndex` property added to `ColorSet`. This allows to specify from which color charts like `PieChart` should start when picking colors for slices.
1744- `excludeFromTotal` property added to `XYSeries` (default: `false`). Allows excluding values of particular series when caluclating totals.
1745- `includeRangesInMinMax` property added to `ValueAxis`.
1746
1747### Changed
1748- The chart will now error out if trying to instantiate generic classes like (`Chart`, `Axis`, `Series`).
1749- Legend in `TreeMap` was completely revamped. Previously it used series as data, but as series were not always created, it failed to render items in some cases. Now it uses `TreeMapDataItem` of `TreeMap`.
1750- `TreeMap` legend will now show items of first level which has more than one data item.
1751- `dataContext` of `ForceDirectedNodeDataItem` will now have the same object as target node's.
1752
1753### Fixed
1754- `responsive.useDefault = false` was being ignored.
1755- `DateAxis` with hourly-based data could render some of the labels using date formatter of a changed period even if the period didn't actually change.
1756- In some cases `MapChart` could interfere with event objects of other charts on the same page, even when not directly interacting with it.
1757- If `baseInterval` of `DateAxis` didn't have `count` set, the chart failed to render.
1758- Setting data on hidden Series resulted tooltips on invisible bullets to be shown.
1759- `WordCloudSeries` with single label or several labels with the same values was displaying labels using `minFontSize`.
1760- `axis.createSeriesRange()` was not working with `RadarColumnSeries`.
1761- When data was added to a chart, series could flicker at incorrect position before rendering properly. Also the same could happen when zooming chart (it was only visible if animated theme was not in use).
1762
1763
1764## [4.4.8] - 2019-05-23
1765
1766### Added
1767
1768- `linkWithStrength` added to `ForceDirectedSeries`.
1769- `linkWith(node, strength)` method added to `ForceDirectedNode`. Allows adding links without revalidating whole data.
1770- `unlinkWith(node)` method added to `ForceDirectedNode`.
1771- `expandAll` property added to `ForceDirectedNode` (default: `true`). If set to `false`, only a single level of children will be expanded on click/tap.
1772
1773### Fixed
1774- Links created using `linkWith` data field were not using any strength setting, affecting the layout.
1775- Some problems with `maxLevels` on `ForceDirectedSeries` solved.
1776
1777
1778## [4.4.7] - 2019-05-21
1779
1780### Changed
1781- Export: Children columns on hierarchical charts (`TreeMap`, `Sunburst`, `ForceDirectedTree`) are no longer exported to "flat" formats (CSV, XLSX).
1782
1783
1784### Fixed
1785- `keepTargetHover` was hiding tooltip when transiting hover from one `Sprite` to another.
1786- Firefox was not displaying texts along paths on a page with `base href` set, due to Firefox [bug](https://bugzilla.mozilla.org/show_bug.cgi?id=455986).
1787- `SunburstSeries` with 0 values were producing a JS error.
1788- Width (or height if vertical) of `Scrollbar`/`Slider` was always 100%, even if it was set to less than 100%.
1789- `WordCloud` with long labels that did not fit into container could get into infinite loop and never get drawn.
1790- If a lot of `GaugeChart` instances with axis bands were rendered on a single page, stack owerflow error could happen.
1791- Adding data to a chart with `XYChartScrollbar` and series in the scrollbar forced full-redraw of scrollbar chart which was making it blink.
1792- Z-indexing of `ColumnSeries3D` columns was incorrect in some cases.
1793- Tooltip of a 3D slice was not in the center of a slice.
1794- Changing of Series' name was not propagating to legend.
1795
1796
1797## [4.4.6] - 2019-05-14
1798
1799### Fixed
1800- Vertical/horizontal bullet positions on `ColumnSeries` were broken since `4.4.5`.
1801
1802
1803## [4.4.5] - 2019-05-13
1804
1805### Changed
1806- Exporting chart data to JSON format now respects `dataFields` setting.
1807
1808### Fixed
1809- Setting `showSystemTooltip = false` on a `Scrollbar` now correctly disables tooltips on its thumb and grips.
1810- When data for `ForceDirectedSeries` was changed for the second time, the old links remained visible.
1811- Initial scatter of `ForceDirectedSeries` nodes reduced. Results in a better initial animation.
1812- Adding data using `addData()` method to a chart with `XYChartScrollbar` was resulting data to be added twice.
1813- With some special combination of axes config `XYChart` sometimes could fall into infinite loop.
1814- Some JS error when converting coordinates out of bounds of AlbersUSA projection fixed.
1815- Tooltip bounds were not being copied when cloning a `Tooltip`.
1816
1817
1818## [4.4.4] - 2019-05-08
1819
1820### Fixed
1821- When data for `ForceDirectedSeries` was changed the old links remained visible.
1822- Legend with custom data was causing a JS error.
1823- Changing data during `rangechangeended` with `skipEmptyPeriods` enabled was triggering "Cannot read property 'getTime[ of undefined" exception.
1824- Slices of `SunburstSeries`, and columns of `TreeMapSeries` were not taking `propertyFields`/`configField` from data.
1825
1826
1827## [4.4.3] - 2019-05-06
1828
1829### Added
1830- `Regression` plugin: two new settings - `simplify` (simplifies output data for faster performance) and `reorder` (orders data in a horizontal linear fashion for scatter plots).
1831- `arrangestarted`, `arrangeended`, and `arrangeprogress` events added to `WordCloudSeries`. Allows showing preloader while building the chart.
1832
1833### Changed
1834- `keepSelection` behavior extended. Now it will keep `ValueAxis` selection while scrolling a perpendicular `DateAxis` or `CategoryAxis`.
1835
1836### Fixed
1837- `Regression` plugin: fixed issue with gaps in data.
1838- Panning chart with `CategoryAxis` out of range, the axis could pan back with one less category in the range when released.
1839- In some cases labels with `bent = true` on `AxisLabelCircular` were positioned incorrectly on `RadarChart`'s Axis ranges.
1840- Safari was not displaying base grid of Y axis in some cases.
1841- Chart could freeze if there was a very small difference between minimum and maximum values of `ValueAxis` (less than 0.00000001).
1842- If `WordCloud` was hidden while arranging words, and then unhidden, the words would overlap in some cases. Arranging of words now stops if container is hidden during the process and resumes when it is unhidden.
1843- 3D columns were cut off on IE if the size of Chart container changed after the chart was already build.
1844- In some setups with `<base href>` some elements were being drawn incorrectly.
1845
1846
1847## [4.4.2] - 2019-05-02
1848
1849### Added
1850- New property for `Label`: `baseLineRatio` (default `-0.27`) controls how "base line" for a label is calculated, and affects positioning of text. The default might not work for all fonts, so this setting can be used to adjust it for precise positioning.
1851- New event for `Sprite`: `"dragged"`. It kicks in right after `"drag"` and can be used to manipulate or correct element's position, which might not be possible using `"drag"` which has built-in position-altering handlers.
1852
1853### Fixed
1854- Export to SVG was not working on Firefox.
1855- Some touch issues wit iOS Safari fixed.
1856- `ValueAxis` could display non-rounded numbers (caused by floating point problem) sometimes.
1857- `maxPanOut` of `MapChart` was being ignored.
1858- Chart scrollbar was not being zoomed out when data of a chart changed.
1859- `RadarChart` with multiple `RadarColumnSeries` with Y as base axis was displaying columns of a 2nd+ series from wrong position.
1860- `chart.dispose()` with a lot of data was very slow. Now it's super fast.
1861- Zoom with mouse wheel was buggy when zooming already zoomed-in `XYChart`.
1862- Gant chart was not updating columns when `chart.invalidateRawData()` was called.
1863- Issue with some `propertyFields` set on a `LineSeries` with no data fixed.
1864- Reseting `relativeRotation` of `AxisLabelCircular` to `undefined` didn't work.
1865
1866
1867## [4.4.1] - 2019-04-22
1868
1869### Changed
1870- Now when using `CSVParsing` for parsing external data, `skipRows` will kick in first, removing X rows from the beginning of data, then `useColumnNames` will use the first row of what's left.
1871
1872### Fixed
1873- JSON: Specifying language locale as string (i.e. "fr_FR") now works in JS setups, provided appropriate language file is loaded.
1874- Grab/Grabbing cursor was not appearing on Scrollbars on Firefox.
1875- `MapChart` used to pan itself when it was zoomed in, `tapToActivate` enabled, and was tapped.
1876- Hovering mouse cursor over an `XYChart` while it was initializing could sometimes result in a JS error.
1877- Issue with `DateAxis` and `Series` not having dates at certain data items fixed. It was cousing problems with multiple date axes mostly.
1878
1879
1880## [4.4.0] - 2019-04-17
1881
1882### Added
1883- Charts now have new property - `tapToActivate` (default: `false`). If set to `true` it will not react to touch drag gestures until user taps on the chart. [More info](https://www.amcharts.com/docs/v4/concepts/touch/).
1884- New element on charts: `dragGrip`. It's a grip that, when enabled, will allow scrolling the page even if the chart functionality does not permit it, e.g. with chart cursor or `MapChart`. [More info](https://www.amcharts.com/docs/v4/concepts/touch/).
1885
1886### Fixed
1887- `NumberFormatter` in charts was ignoring locale settings.
1888- `TreeMap` could crash across data update.
1889- In some situations `XYCursor` with `"panX"` behavior would not allow panning the chart completely to the edge of data.
1890
1891
1892## [4.3.15] - 2019-04-16
1893
1894### Added
1895- `startendchanged` event added to `Component`. Fired when `start` or `end` is changed. Unlike `startchanged`/`endchanged` this event is fired not immediately but at the end of a cycle.
1896
1897### Changed
1898- `Sunburst` chart's defaalt `radius` set to `95%`.
1899
1900### Fixed
1901- `TreeMap` could produce a JS error if data was changed during interaction with the map.
1902- If `Component.addData()` called before chart was initialized, error happened.
1903- 3D columns with reversed base axis had wrong z-indexes.
1904- `DateAxis`-based chart with single data item got into infinite loop if `startLocation` and `endLocation` were set to `0.5` or `strictMinMax` was set to `true`.
1905- Tooltips of series could overlap if series used different `DateAxis` axes.
1906- Chart with multiple `DateAxis` and no animated theme was not properly zooming with scrollbar.
1907- Implemented a workaround for MSIE which was not updating series masks on chart resize.
1908- Disposing `XYCursor` will now remove series/axes tooltips that might be currently displayed because of it.
1909
1910
1911## [4.3.14] - 2019-04-13
1912
1913### Added
1914- New `SliceGrouper` setting: `syncLegend` (default `false`). If set to `true` the legend will be updated dynamically to show only those slices that are currently visible.
1915- Plugin `Regression`: new property `result` will store all the results including formula and caculated points.
1916- Plugin `Regression`: plugin now has `events` which can be used to attach event handlers such as `"processed"`.
1917
1918### Fixed
1919- `Animation` was failing when source value was string (i.e. "auto") and target value was number (i.e. 10).
1920- JSON: Object entries in a `List` were not being their properties set.
1921- `MapChart` sometimes could place Map images at incorrect positions.
1922
1923
1924## [4.3.13] - 2019-04-10
1925
1926### Fixed
1927- Using `propertyFields.url` was forcing pointer cursor on all objects from the same template, even if they did not have url set.
1928- Memory leak with dynamic changes of data on `TreeMap`.
1929- `getPoint()` method of `XYSeries` is now public.
1930- Setting `startAngle`/`endAngle` before adding `PieSeries` was causing it to not be drawn.
1931- Performance tweaks to 3D columns.
1932
1933
1934## [4.3.12] - 2019-04-09
1935
1936### Changed
1937- Series' `bullets` now accepts objects that are simple `Sprite` elements, not just `Bullet` types. This means you can add `Circle` as bullet (or any other element), to dramatically improve performance on bullet-heavy charts.
1938- Default value of `hideOversized` for `LabelBullet` changed to `false`.
1939
1940### Fixed
1941- Dramatically improved performace of `CategoryAxis`.
1942- `SliceGrouper` plugin will now not add "Other" slice if there are no slices below threshold or no data at all.
1943- `SliceGrouper` now supports dynamic data updates.
1944- `ColorSet.reuse = true` was working incorrectly for `PercentSeries`.
1945- `timezoneOffset` property of the Date Formatter was causing all minutes to be formatted as zeroes.
1946
1947
1948## [4.3.11] -2019-04-08
1949
1950### Added
1951- New plugin: `SliceGrouper` (allows automatically grouping small slices on any `PercentSeries`, e.g. Pie, Funnel, Pyramid, or Pictorial Stacked). [More info](https://www.amcharts.com/docs/v4/tutorials/plugin-slice-grouper/).
1952
1953### Changed
1954- Changed `centerStrength` default was changed to `0.8` in `ForceDirectedSeries`.
1955
1956### Fixed
1957- Zero-value 3D columns were not visible on `DateAxis`.
1958- `FunnelSeries`'' labels were out of bounds sometimes.
1959- `Regression` plugin was not working when data was set directly on Series.
1960
1961
1962## [4.3.10] - 2019-04-08
1963
1964### Changed
1965- Corner radius is not supported anymore on 3D slices. A sacrifice towards performance.
1966
1967### Fixed
1968- Performance of `PieChart3D` improved dramatically.
1969
1970
1971## [4.3.9] - 2019-04-06
1972
1973### Added
1974- `ForedDirectedSeries` properties `minRadius` and `maxRadius` can now be set in `Percent`.
1975
1976### Changed
1977- Default value of `ForceDirectedLink.strength` changed to `1` to avoid initial shaking.
1978- Default value of `ForceDirectedSeries.manyBodyStrength` changed to `-15`.
1979- Default values of `ForceDirectedSeries` properties `minRadius` and `maxRadius` changed to `1%` and `8%` respectively.
1980
1981### Fixed
1982- In `ForedDirectedSeries` the same color was being reused for top-level node and first child node.
1983- It was impossible to set colors of `ForedDirectedSeries` data items via data.
1984- `ColorSet` setting `reuse = true` was acting incorrectly.
1985
1986## [4.3.8] - 2019-04-05
1987
1988### Added
1989- New chart type plugin: `ForceDirectedTree`. [More info](https://www.amcharts.com/docs/v4/chart-types/force-directed/). Also check bundled examples: `force-directed-tree`, `force-directed-tree-expandable`, and `force-directed-network`.
1990- New `CategoryAxis` property: `positionToCategory(position)`.
1991
1992
1993## [4.3.7] - 2019-04-04
1994
1995### Fixed
1996- `TreeMap` was erroring out since `4.3.6` unless "animated" theme was enabled.
1997- On `TreeMap`'s legend with default markers `valueLabels` was not working on first load.
1998
1999
2000## [4.3.6] - 2019-04-04
2001
2002### Added
2003- New `DateFormatter` property: `timezoneOffset`. Set it to a number of minutes (to UTC) to recalculate all date/time to a specific time zone.
2004
2005### Changed
2006- `DateFormatter` will now use locale information for its default date format set in `dateFormat`. Format in default "International English" locale did not change, and remains at `"yyyy-MM-dd"`. Other locales might or might not produce different date formats.
2007- Improved `ValueAxis` scale calculation algorithm when `min`/`max` is set.
2008- `"hit"` event is now added on `FlowDiagramNode` template instead of the class itself. This allows disabling default toggle/drag behavior and replacing with own events.
2009
2010### Fixed
2011- Themes were not properly being applied to bullets.
2012- `Popup.draggable` was being ignored.
2013- `Series.legendSettings.itemValueText` was being ignored when `cursorTooltipEnabled = false`. #1141
2014- Mouse events over `LineSeries` segments where happening at wrong position.
2015- `legend.valueLabels` on `TreeMap` did not work.
2016- Changing Map projection with `panBehavior = "rotateLongLat"` could cause a JS error.
2017- Changing `TreeMap` data after chart size changed could cause zoom-out button to appear.
2018- Solved flickering of stacked columns when raw data was invalidated.
2019- Updating data of a `TreeMap` when animation was playing could result in a JS error.
2020
2021
2022## [4.3.5] - 2019-03-29
2023
2024### Added
2025- New properties `strokeLinejoin` ("miter" | "round" | "bevel") and `strokeLinecap` ("butt" | "square" | "round") added to `Sprite`. [More info](https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial/Fills_and_Strokes#Stroke).
2026
2027### Fixed
2028- In some rare cases EDGE/IE could generate an "Unspecied error".
2029- `MapChart` method `zoomToMapObject()` was not functioning properly since `4.3.4`.
2030- `LineSeries` with bullet and `hidden = false` in init was causing the whole chart to break.
2031
2032
2033## [4.3.4] - 2019-03-28
2034
2035### Fixed
2036- Issue with JSON setups for `MapChart` fixed.
2037
2038
2039## [4.3.3] - 2019-03-27
2040
2041### Fixed
2042- `MapPolygonSeries.geodataSource` was not working.
2043- `MapChart` was not showing data if `geodata` was set later than data on series.
2044- When there were multiple data items with identical timestamps on `DateAxis`, the first ones could have been ignored.
2045- Even if `legend.itemContainer.template.togglable` was set to `false`, Legend item was stil togglable.
2046- Extra graticules (grid) was shown in `GraticuleSeries` unders some conditions.
2047- Tooltips on a logarithmic `ValueAxis` were showing wrong values.
2048- Value label for "0" could sometimes appear on top of logarithmic `ValueAxis`.
2049- `MapChart` position was not correct if padding was set.
2050
2051
2052## [4.3.2] - 2019-03-26
2053
2054### Fixed
2055- `MapChart` dispose error fixed.
2056
2057
2058## [4.3.1] - 2019-03-26
2059
2060### Fixed
2061- Bug with live data updates fixed.
2062
2063
2064## [4.3.0] - 2019-03-26
2065
2066### Added
2067- `MapChart` can now use any projection supported by [d3-geo](https://www.npmjs.com/package/d3-geo). `Projection.d3Projection` property added and you can set any d3-geo projection using it, like: `mapChart.projection.d3Projection = am4maps.d3geo.geoConicEquidistant();`.
2068- Albers, AlbersUsa, AzimuthalEqualArea, EqualEarth, NaturalEarth1, Stereographic projection classes added (use them regularly like: `mapChart.projection = new EqualEarth()`).
2069- `deltaLatitude`, `deltaGamma` added to `MapChart`. Together with already existing `deltaLongitude` allows rotating maps in any possible direction.
2070- `panBehavior` property added to `MapChart`. Values: "move" (default), "rotateLat", "rotateLong", "rotateLongLat". Indicate what should happen when map is dragged.
2071- `ignoreBounds` added to `MapSeries`. Specifies if this series must be included when calculating bounds of the map.
2072- `calculateVisualCenter` added to `MapPolygonSeries`. Specifies if map polygons should calculate their visual center. Visual center is good for placing labels.
2073- `visualLongitude` and `visualLatitude` getters added to `MapPolygon`. They return coordinates if `calculateVisualCenter` of series is set to `true`. You can also set them manually.
2074- `getCircle()` and `getBackground()` methods added to `MapUtils`.
2075- `Graticule` and `GraticuleSeries` classed added. Those allow creating graticules (map grid).
2076- `backgroundSeries` added to MapChart. Allows creating a map-shaped background fill.
2077
2078### Changed
2079- Engine behind rendering of maps was changed to use [d3-geo](https://www.npmjs.com/package/d3-geo).While the change should be backwards compatible, beware of and report any issues.
2080- `day-night-map` and `morphing-countries` demos we changed to work properly with new version.
2081- When adding a `HeatLegend` to `MapChart` its `valign = "bottom"` is no longer set by default. Set it explicitly if you need legend to bottom-aligned.
2082
2083### Fixed
2084- `rtl` setting was not being inherited properly.
2085- Fixed RTL behavior for labels.
2086- Disposing a hovered chart with scroll pan enabled used to leave whole document with disabled wheel scroll.
2087
2088
2089## [4.2.6] - 2019-03-21
2090
2091### Fixed
2092- `CategoryAxis` was breaking down after dynamic data update since 4.2.4.
2093
2094
2095## [4.2.5] - 2019-03-21
2096
2097### Added
2098- New property `minPolylinestep` added to global `am4core.options`. Setting to bigger value (default: `0.5`) allows simplification of multi-point lines.
2099- Export: new setting `useSimplifiedExport` (default: `true`). Setting to `false` will force use of external library (canvg) for all exports.
2100
2101### Fixed
2102- `XYCursor` with pan behavior used to remain in "grabbing" mode after click on zoom out button.
2103- Export: Menu was not working properly on Mobile Safari.
2104- Export: Menu was not working properly on Android Chrome.
2105- Export: Exporting of PDF/XSLX is now supported on Mobile Safari.
2106- Export: Exporting images in IE9 was broken.
2107- Stacks with pre-hidden series were showing incorrectly.
2108- `DateAxis` no longer ignores `renderer.tooltipLocation`.
2109
2110
2111## [4.2.4] - 2019-03-19
2112
2113### Added
2114- `autoGapCount` added to `LineSeries`. If `connect = false` and distance between two data points is bigger than `baseInterval * autoGapCount`, a line will break automatically.
2115
2116### Fixed
2117- `IPlugin` now accepts `Optional<Sprite>`.
2118- `XYCursor` will not longer obstruct page scroll if its `behavior` is set to `"none"`.
2119- JSON config: setting `geodata` by name (e.g. "worldLow") directly in `MapSeries` was not working.
2120- JSON config: Instantiating new `ColorSet` objects was not working properly.
2121- `DateFormatter` was not parsing dates like "20180101" (no separators) correctly.
2122- An issue with `DateAxis` and milliseconds fixed.
2123- `dataItem.locations.dateX` on `LineSeries` was not working properly.
2124
2125
2126## [4.2.3] - 2019-03-14
2127
2128### Fixed
2129- Exporting via API from a chart that did not have `ExportMenu` set, was resulting in error.
2130- Fixed tooltip flickering that were set directly on series objects (columns/bullets).
2131- Because of daylight saving, sometimes `DateAxis` could mistake yearly data for monthly data if `baseInterval` was not set explicitly.
2132- Sometimes Sankey nodes did not perfectly fit into chart area.
2133- Tick `location` on Y axis was being ignored.
2134- Ticks were positioned incorrectly when multiple axes were on the same side of the `XYChart`.
2135- Issue with `strictMinMax` and single data item fixed.
2136- `valueY` (or any other value) wasn't working in `legendSettings.itemLabelText`.
2137
2138
2139## [4.2.2] - 2019-03-13
2140
2141### Added
2142- `cursorHoverEnabled` added to `XYSeries`. Controls whether to trigger hover state on columns/bullets of the all series under hovered category/date.
2143- A new `plugins` property on all `Sprite`. [More info](https://www.amcharts.com/docs/v4/concepts/plugins/).
2144- New plugin: Regression. [More info](https://www.amcharts.com/docs/v4/tutorials/regression-trend-lines/).
2145- New `ExportMenu` setting: `closeOnClick` (default `true`). Will force export menu to close when export is initiated.
2146
2147### Changed
2148- `DateFormat` will now parse even partial dates, e.g. format `"yyyy-MM-dd"` will parse `"2018"` correctly, and will assume Jan 1st.
2149
2150### Fixed
2151- Export: `getImage()`/`getSVG()` will now correctly omit `exportable = false` elements.
2152- Export: Data export was not taking in additional columns after data updates.
2153- Some chart cloning issues fixed.
2154- Inccorrect behavior of Series' tooltip with `minBulletDistance` set fixed.
2155- Sometimes, when series had only one data item, chart used to zoom-in right after the init.
2156- In-line date formatting will now use `DateFormatter`'s parsing functions for string-based dates.
2157- `DateAxis` issues with certain timezones fixed.
2158
2159
2160## [4.2.1] - 2019-03-08
2161
2162### Fixed
2163- Various graphical issues when using `<base>` tag (mostly affects Angular).
2164- `NumberFormatter` did not have a public accessor to set `negativeBase`.
2165
2166
2167## [4.2.0] - 2019-03-06
2168
2169### Added
2170- Added read-only property of `CategoryAxis`: `frequency`. Indicates every X label is shown.
2171- Added JSON example of Candle stick chart (json/candlestick-series).
2172- New `Export` property: `extraSprites`. May contain a list of references to other `Sprites` (e.g. external legend or even other chart) to attach to exported image. [More info](https://www.amcharts.com/docs/v4/concepts/exporting/#Including_external_elements).
2173- Experimental responsive features and default rules are now active. [More info](https://www.amcharts.com/docs/v4/concepts/responsive/).
2174
2175### Changed
2176- Accessibility: Default role of the Legend's item containers was changed to "switch".
2177
2178### Fixed
2179- Accessibility: Legend's containers when toggling items were setting value of `aria-checked` incorrectly.
2180
2181
2182## [4.1.14] - 2019-03-01
2183
2184### Changed
2185- Hiding or showing an element will now automatically set its `readerHidden` attribute accordingly.
2186
2187### Fixed
2188- JSON: Using `children` with an array value was duplicating elements.
2189- Working around a bug with Angular's dead code elimination in `--prod` mode.
2190- Fixed `ValueAxis` issue with animation when there's only single data item.
2191
2192
2193## [4.1.13] - 2019-02-26
2194
2195### Added
2196- New `Tooltip` proprety: `keepTargetHover` - will make target element hovered as long as its tooltip is hovered, good for bullets and map images.
2197- New `Tooltip` proprety: `targetSprite` - contains reference to element this tooltip is displayed for, if any.
2198- New `PictorialStackedSeries` properties: `startLocation` and `endLocation` - allow setting relative start and end positions of the shape to fill.
2199- New `FunnelSeries`/`PyramidSeries`/`PictorialStackedSeries` property: `labelsOpposite` - allows controlling which side of the series to show labels when `alignLabels = true`.
2200
2201### Fixed
2202- Sometimes axis ticks on a chart with a lot of data/series were not positioned properly.
2203
2204
2205## [4.1.12] - 2019-02-25
2206
2207### Changed
2208- On `MapPolygon` default value of `nonScalingStroke` is now set to `true` (as `false`).
2209- When calculating font size for a word on a `WordCloud` chart it now uses smaller side of the series area instead of height.
2210- `Tooltip`'s label `paddingBottom` default value changed from `6` to `4` pixels for better centering of text.
2211
2212### Fixed
2213- Sometimes `baseInterval = "year"` on a `DateAxis` could cause stack overflow.
2214
2215
2216## [4.1.11] - 2019-02-25
2217
2218### Changed
2219- Default value of `minFontSize` in `WordCloudSeries` to `2%`.
2220- Default value of `maxFontSize` in `WordCloudSeries` to `20%`.
2221- Label sizing algorithm updated in `WordCloudSeries`.
2222
2223
2224## [4.1.10] - 2019-02-24
2225
2226### Added
2227- New chart type: [WordCloud](https://www.amcharts.com/docs/v4/chart-types/wordcloud/).
2228
2229### Changed
2230- Rotated axis labels (`rotation != 0`) of the vertical and horizontal axes no longer have their `verticalCenter` and `horizontalCenter` overridden by renderer. This gives more freedom for positioning rotated labels.
2231
2232### Fixed
2233- `exportable = false` was not working when set on various Series item templates.
2234- On Gantt chart date axis tooltip was snapping randomly when moving mouse.
2235- Export: For very large data sets (2MB and up) data export was failing silently in Chrome.
2236
2237
2238## [4.1.9] - 2019-02-20
2239
2240### Added
2241- New `Sprite` property: `baseSprite`. On objects, even deep in hierarchy it will contain a reference to the main chart object.
2242
2243### Changed
2244- Axis `min`/`max` calculation algorightm updated.
2245
2246### Fixed
2247- On a chart with `DateAxis` and multiple series with same-date data items, bullets could sometimes disappear while scrolling the chart.
2248- On `DateAxis` with yearly granularity could sometimes show wrong year.
2249- Updating chart `data` with less data points was sometimes resulting in JavaScript error.
2250- `DateAxis` labels/ticks/grid was not placed in the correct position if `baseInterval.count > 1` and `location > 0`.
2251- Dynamically changing `ZoomControl` value of `layout` was not working correctly.
2252
2253
2254## [4.1.8] - 2019-02-15
2255
2256### Added
2257- JSON: You can now specify both list of items and template settings for `ListTemplate`, e.g.: `titles: { template: { ... }, values: [{ ... }] }`. Specifying it the old way will still work.
2258
2259### Changed
2260- `DateAxis` will now pay attention to `dateFormatter.firstDayOfWeek` when grid is in "weekly" mode.
2261
2262### Fixed
2263- Using `proprtyFields` on a `LineSeries` sometimes could result in an error. (fix by @AndiLi99)
2264- French locale (fr_FR) updated for correct decimal/thousands separators.
2265- Export: `scale` in image export options was being ignored.
2266- JSON: `cursor.snapToSeries` was not working in JSON configs.
2267- Selection was acting funky when zooming `DateAxis` and cursor moved out of plot area.
2268- An infinite error message loop fixed which was happening if series was added and there was no X or Y axes defined.
2269- Tooltip on the last available data item was left visible even if cursor moved to the date where the series had no data points.
2270- When `snapToSeries` was enabled in `XYCursor`, vertical line was not shown.
2271- [Issue 933.](https://github.com/amcharts/amcharts4/issues/933)
2272
2273
2274## [4.1.7] - 2019-02-14
2275
2276### Fixed
2277- `DateAxis` sometimes could show date/time in UTC even if not explicitly enabled.
2278
2279
2280## [4.1.6] - 2019-02-12
2281
2282### Added
2283- New plugin chart type: [`Sunburst`](https://www.amcharts.com/docs/v4/chart-types/sunburst/)!
2284- New `Sprite` adapter: `criticalError`. Takes `Error` object as an argument. Modify it's `message` property.
2285
2286### Fixed
2287- Export was somewhat broken in Angular apps or pages with `<base>` since 4.1.5.
2288- `DateAxis` was not positioning elements properly when spanning switch to/from daylight savings time.
2289- `valign` property of the horizontal axis labels now work properly.
2290
2291
2292## [4.1.5] - 2019-02-11
2293
2294### Added
2295- New property `contextMenuDisabled` (default `false`) added to `Sprite`. If set to `true` it will prevent context menu (such as one displayed on right click) from displayed.
2296
2297### Changed
2298- Setting `data` on `ColorSet` will now automatically reset iterator.
2299
2300### Fixed
2301- `"rightclick"` event was essentially not working.
2302- Angular with router enabled were breaking charts in Safari and older Firefox.
2303
2304
2305## [4.1.4] - 2019-02-08
2306
2307### Added
2308- `DateAxis.gridInterval` accessor added. Returns current grid interval.
2309
2310### Fixed
2311- Calling `useTheme()` with the same theme multiple times used to cause that theme applied multiple times as well.
2312- Sometimes `ValueAxis` would not zoom-out to show new selected range when data was updated.
2313- Sometimes axis fills were not visible after zoom-in / zoom-out.
2314- `totalPercent` was not properly calculated with negative values.
2315
2316
2317## [4.1.3] - 2019-02-06
2318
2319### Fixed
2320- `ExportMenu` items will be revalidated if data of the chart is updated. This helps avoid missing "Data" export items in menu if data is loaded later than the chart itself.
2321- In stacked axes setup axis tooltips were shown in wrong positions.
2322- Preloader was not always shown when needed.
2323- JavaScript error when hovering cursor over missing data items fixed.
2324- `TreeMap` data change performance improved.
2325- Horizontal `ZoomControl` (`layout = "horizontal"`) button text vertical align fix.
2326- Accellerated panning of zoomed-in axis problem fixed.
2327
2328
2329## [4.1.2] - 2019-02-05
2330
2331### Added
2332- New `Sprite` property `strokeDashoffset` added. Can be used in conjunction with `strokeDasharray`.
2333- `Label` has two new properties: `path` and `locationOnPath`. If set, will layout the SVG text along a curvature of the SVG path. HTML and multi-line text is not supported.
2334- `AxisLabelCircular` new property `bent` added. If set to `true`, the label will be bent to follow the curvature of the circle. Distance from the circle can be adjusted using `radius` and `label.paddingBottom`. For `PieSeries` the alignLabels need to to be set to `false` for this feature to work.
2335
2336### Fixed
2337- JSON: Having property values with both percent and minus signs in them, was resulting in error.
2338- "Z" code in `DateFormatter` was not taking UTC setting into account.
2339- Exporting SVG with Unicode characters in Edge/IE was resulting in invalid SVG.
2340- Fixed JavaScript error which used happen when disposing chart/changing data in some cases.
2341- Gantt chart sometimes was not displaying first/last data item.
2342- Newly added `MapLine` elements were not respecting `nonScalingStroke = true` until zoom level changed.
2343- Series' tooltip was not always visible with `DateAxis`.
2344
2345
2346## [4.1.1] - 2019-01-31
2347
2348### Added
2349- `keepSelection` added to `ValueAxis` (will work on DateAxis too). With this set to `true`, axis will keep the relative selection when data changes (is updated). This is useful for "pre-zooming" a date axis: just set it's `start` property (e.g. `axis.start = 0.8`).
2350
2351### Changed
2352- If `ValueAxis` has `strictMinMax = true` set but `min` and `max` are not set, axis will fix the min and max and real high/low values.
2353
2354### Fixed
2355- `cursorTooltipDisabled = true` was not working properly in some cases.
2356- Sometimes duplicate `MapLineObjects` used to appear on map lines.
2357- Some fixes made so that vertically and horizontally stacked axes on `XYChart` are now possible. Check new example in `examples/vertically-stacked-axes`.
2358
2359
2360## [4.1.0] - 2019-01-30
2361
2362### Changed
2363- Standalone scripts were recompiled to use unique Webpack scope, to avoid conflicts with other Webpack packages. If you are using map charts, to avoid breakage, make sure you update to 4.1 version of geodata package as well.
2364
2365### Fixed
2366- Performance optimizations of date-based charts, especially with more than one series.
2367- Overlapping tooltips of series with gaps in date-based data fixed.
2368- Bullets were not hidden when series was hidden in some cases.
2369- `simplifiedProcessing` moved from `ColumnSeries` to `Series`. If set to `true` (default `false`) the chart will not auto-calculate derivative values for data items, like sum, average, change, etc.
2370- Last grid of monthly data was not always drawn.
2371
2372
2373## [4.0.24] - 2019-01-25
2374
2375### Fixed
2376- `nonScalingStroke` (broken in 4.0.23) fixed.
2377- Legend custom adapters problem (broken in 4.0.23) fixed.
2378
2379
2380## [4.0.23] - 2019-01-25
2381
2382### Changed
2383- `PieChart3D` property `angle` is now limited to 0-90 range.
2384
2385### Fixed
2386- `LabelBullet` was not showing text on `RadarChart` without some additional tweaking.
2387- Clicking and releasing on plot area without moving cursor sometimes could result in chart zooming in.
2388- Bullets for `PieSeries`, `FunnelSeries` were not positioned properly.
2389- Labels of `PieSeries3D` were not being positioned properly if `alignLabels = false` and `label.radius < 0`.
2390- Axis' grid was not hidden when axis was hidden.
2391- It was not possible to disable funnel series ticks if `alignLabels = true`.
2392- Adding a `MapLine` on zoomed `MapChart` ignored `nonScalinStroke = true` until zoom.
2393- On Gantt chart horizontal axis' labels/grid used to bleed out outside the plot area when zoomed in significantly.
2394- Columns of `ColumnSeries` with `strokeOpacity > 0` could leave lines at the beginning/end of the plot area when zoomed-in.
2395- Adapters for `fontSize`, `textDecoration` and some other `Label`-related properties were not working properly.
2396- Chart legend was not updated if data was set directly on `PercentSeries`.
2397- `MapChart` was drawing only 109 MapLines in some cases.
2398- `MapLine` tooltip was not being positioned properly.
2399- When `invalidateRawData()` was called for a chart with a `DateAxis` while it was zoomed-in, the chart was not keeping current zoom.
2400- If data was added to a series while it was hidden, bullets of new data items were not hidden.
2401- `columns` of `ColumnSeries` were not being cleared when data was updated.
2402- `propertyFields.fill`/`stroke` was not respected when value was outside zoom range.
2403- Ticks on a `PieChart3D` were misaligned.
2404- `Preloader` of a second and any subsequent chart on the same page was not being centered.
2405- `PercentChart` legend markers where black if `legend.useDefaultMarker = true`.
2406- `PercentChart` legend markers could blink black initially before obtaining true color.
2407- The color scale on a vertical `HeatLegend` with `markersCount > 2` was being drawn reversed.
2408
2409
2410## [4.0.22] - 2019-01-23
2411
2412### Added
2413- 23 new locales: Arabic, Bosnian, Catalan, Czech, Greek, Estonian, Finnish, Hebrew, Hindi, Croatian, Hungarian, Indonesian, Japanese, Korean, Latvian, Polish, Romanian, Serbian, Thai, Turkish, Vietnamese, Chinese (simplified and traditional versions). Thanks Bjorn Svensson!
2414
2415### Fixed
2416- It is no longer necessary to use `"strictFunctionTypes": false`, [thanks to goloveychuk for their help](https://github.com/amcharts/amcharts4/pull/645).
2417- Broken images were causing export to fail.
2418- Setting Series' `name` to a number with percent sign was resulting in breakage of the whole chart.
2419
2420
2421## [4.0.21] - 2019-01-11
2422
2423### Fixed
2424- Issues that caused errors in Map an Percent charts on data update and dispose fixed.
2425
2426
2427## [4.0.20] - 2019-01-11
2428
2429### Fixed
2430- Chart with `ColumnSeries` was failing with an error when `data` was updated.
2431
2432
2433## [4.0.19] - 2019-01-11
2434
2435### Fixed
2436- `MapLineSeries` with direct `data` set were somewhat broken since last update.
2437
2438
2439## [4.0.18] - 2019-01-10
2440
2441### Added
2442- JSON: Better id checking and error reporting.
2443
2444### Fixed
2445- Export menu no longer shows DATA menu for `MapChart` (and other charts if data is empty).
2446- JSON: Some empty properties like `dummyData` were not being set properly.
2447- Disposing a chart or series when `Legend` was enbled was resulting in error.
2448
2449
2450## [4.0.17] - 2019-01-09
2451
2452### Fixed
2453- Dramatically improved performance for data-heavy charts (with 10s and 100s of thousands of data points).
2454- `SmallMap` viewport indicator rectangle was positioned incorrectly.
2455- Clicking on `SmallMap` was not moving map to corthis.component.rect location.
2456- Lines from GeoJSON were not drawn by `MapLineSeries`.
2457- Issue with multiple data points on the same date fixed (not all data points were visible at the end of selection).
2458
2459
2460## [4.0.16] - 2019-01-05
2461
2462### Added
2463- New locales: Norwegian Bokm? (np_NO), Danish (da_DK).
2464
2465### Changed
2466- Renamed Swedish locale to `sv_SE`.
2467
2468### Fixed
2469- Interactions on MacOS Safari was broken sincle last update.
2470
2471
2472## [4.0.15] - 2019-01-04
2473
2474### Added
2475- `color` property added to `LegendDataItem`. Can be used for coloring `label` or `valueLabel` text like `text = "[{color}] {name}"`.
2476- `minZoomCount` added to `Component`.
2477- Export now allows formatting numberic values as durations. Use newly added `durationFields` and `durationFormat` settings.
2478
2479### Changed
2480- Export: When exporting date to XLSX, date fields will now export as true date fields in Excel (which in turn will format them according to regional settings), unless `useLocal` is set to `false`.
2481
2482### Fixed
2483- Charts were not working properly in FireFox Extended Support Release.
2484- Some computer setups were not properly registering mouse movement.
2485- `legendSettings` was being ignored initially if legend was in external container.
2486- "Week year" (format code `"YYYY"`) was not being properly calculated.
2487
2488
2489## [4.0.14] - 2019-01-02
2490
2491### Added
2492- New setting `zoomStep` added to `MapChart`. Allows controlling zoom in/out speed.
2493
2494### Fixed
2495- `Series.hidden` did not work as expected.
2496- World map did not work in Ember.
2497- Eliminated multiple warnings in recent version of Chrome regarding wheel events being active.
2498- Fixed mousewheel zoom in IEs.
2499- Draggable/resizable items were not working properly on some Android browsers.
2500- Setting `height` to a relative value for a horizontal `ColumnSeries` column template was not working propertly.
2501
2502
2503## [4.0.13] - 2018-12-26
2504
2505### Fixed
2506- Charts were broken in IE9.
2507
2508
2509## [4.0.12] - 2018-12-24
2510
2511### Fixed
2512- Cursor/mouse operations were somewhat broken in IE11 and lower.
2513
2514
2515## [4.0.11] - 2018-12-24
2516
2517### Added
2518- `"disabled"` and `"enabled"` events added to `Sprite`.
2519- `cursorTooltipEnabled` added to `XYSeries` If set to `false` cursor will not trigger bullet/item tooltips on series.
2520
2521### Changed
2522- IMPORTANT (CODE-BREAKING CHANGES) For performance reasons we no longer create axis elements if they are disabled. For the same reasons we disabled by `axis.ticks` and `axis.axisFills` by default. Previously to enable them you had to set their `strokeOpacity` and/or `fillOpacity` to non-zero. This no longer will work. You will need to set `disabled` to `false` instead.
2523- `axisRanges` now take their default values from `dateAxis.axisRanges.template` items (`axisFill`, `grid`, `tick`, `label`). Previously they were using the defaults from `dateAxis.renderer.label` etc. This was not comfortable and counter-intuitive.
2524
2525### Fixed
2526- `XYChartScrollbar`'s value axis was calculating `min`/`max` with a very big step.
2527- Ember plugin was throwing console errors.
2528- Fixed occasional zoom-in issue on Mobile Safari.
2529- `MapChart` mouse wheel zoom direction was inverted on some browsers.
2530- Cursor was not snapping correctly to `DateAxis` items.
2531- Multiple floating columns on the same category were disappearing when scrolling the chart.
2532- Date range fills were off when zooming on Gantt Chart.
2533- Overlapping tooltips problem solved.
2534- When `snapToSeries` was set for a tooltip, it was flickering a lot on slower browsers.
2535- `alignLabels = false` on a `PieSeries3D` was causing labels to be positioned incorrectly.
2536- `PieSeries.dataFields.radiusValue` was not accounting for `chart.innerRadius`.
2537- Dynamically updating `alignLabels` for `PieSeries` did not work correctly.
2538- Legend: `itemValueText` only worked if `valueText` was set.
2539- `ValueAxis` setting `maxZoomFactor = 1` was not working as expected.
2540- Changing values for all data items sometimes was resulting in `ValueAxis` scale going into negative.
2541- Some more tooltip and cursor related issues fixed.
2542- Axis Fill did not properly fill the whole span when axis was scaled.
2543
2544
2545## [4.0.10] - 2018-12-20
2546
2547### Fixed
2548- In some situations, when `geodataSource` had events set, it was producing error.
2549- `DateAxis` was not rounding intervals properly, could display grid at `15:01`, `15:31` etc.
2550- Cloning an object was cloning sometimes was causing event handlers to be duplicated.
2551- A leftover console debug line was removed.
2552
2553
2554## [4.0.9] - 2018-12-19
2555
2556### Added
2557- `snapToSeries` added to `XYCursor`. Allows setting series to which cursor lines should be snapped. Works if one of the axis of the series is `DateAxis` or `CategoryAxis`. Won't work if both axes are `ValueAxis`.
2558- New example: Pie charts in Columns using JSON config.
2559- Export: `emptyAs` added to both CSV and Excel export options. If set, missing values will be replaced with this value (default is empty string).
2560- New event `"beforedisposed"` added to `Sprite`. Kicks in right before the element starts to dismantle itself.
2561- Italian translation.
2562
2563### Changed
2564- Export: if no `dataFields` specify it will now look for fields in all of the data, not just the first line.
2565- When creating a new state on an object, it will not automatically propagate itself on object's clones if `applyOnClones = true`.
2566- Setting `Container`'s `setStateOnChildren` will now propage to the new value to its existing clones if `applyOnClones = true`.
2567- In case `deepInvalidate()` is called on `Container`, it forces labels to redraw.
2568- `filters` on `SpriteState` is now `List` (was `ListTemplate`). It's better for performance which does not require creating Filter template object.
2569
2570### Fixed
2571- Clicking a hoverable/clickable object was resultin in "over" and "out" events generated next to "hit".
2572- JSON: properties to existing `List` items were not being applied properly.
2573- Using geodata in Ember app was causing errors (Issue 672).
2574- Export to CSV/Excel was following first line of data values. It now respects `dataFields` setting, and will replace missing values with `emptyAs` (new options setting).
2575- Wheel-scrolling in MacOS Safari was very slow.
2576- HTML-based tooltips were too small to fit the actual contents on MaCOS Safari.
2577- `DateFormatter` was not parsing `"i"` format as local timezone, rather than UTC.
2578- Sometimes bullets with `Rectangle` element in them were not positioned properly.
2579- If category was named `"undefined"`, it was messing up label positions on `CategoryAxis`.
2580- State's property value was not being applied if current value of the property was `undefined`.
2581- Performance of `PieChart` and `RadarChart` improved dramatically under IEs.
2582- In some cases `"ready"` event was not being fired.
2583- `FunnelSeries` with 0 (zero) value slices was not rendered correctly.
2584
2585
2586## [4.0.8] - 2018-12-11
2587
2588### Added
2589- `currentStep` added to `ColorSet`. Allows setting current position of the color iterator.
2590- Adapters added for `Sprite` properties: `inertiaOptions`, `hitOptions`, `hoverOptions`, `swipeOptions`, `keyboardOptions`, `cursorOptions`.
2591
2592### Changed
2593- `nonScaling` of `AxisLabel` is no longer set to `true` by default, to improve performance.
2594
2595### Fixed
2596- `ValueAxis` was not updating its scale if series was hidden and animated theme was not enabled.
2597- Zooming an `XYChart` with all values equal was broken.
2598- Series in an `XYChartScrollbar` sometimes was not visible initially.
2599- `ColumnSeries` was drawing 1px line for `null` value data items.
2600- `DateAxis`' `snapTooltip = true` was working incorrectly with `skipEmptyPeriods = true`.
2601- Logarithmic `ValueAxis` with axis breaks was resulting in stack overflows.
2602- JSON: Chaining multiple adapters in an array (e.g. `adapter: [{...}, {...}]`), was not working.
2603- JSON: Adding elements to `children` via array syntax was not working properly.
2604- JSON: `Container` elements can now be created via JSON config.
2605- Setting `dataFields` in `Export` was only affecting column names. Values for all data fields were still being included in export.
2606
2607
2608## [4.0.7] - 2018-12-07
2609
2610### Added
2611- `snapTooltip` with default value `true` added to `DateAxis`. Cursor will snap to the nearest date at which series has values.
2612
2613### Changed
2614- Default value of `showOnInit` set to `false` for `TreeMapSeries`.
2615
2616### Fixed
2617- Solved tooltip overlapping bug.
2618- In `TreeMap`, when series is toggled off, remaining series will be resized to take up freed space.
2619
2620
2621## [4.0.6] - 2018-12-06
2622
2623### Added
2624- `snapTooltip` added to `XYSeries`, with default value `false`. If set to `true`, the series will show nearest available tooltip when cursor is over plot area.
2625- Slovenian translation.
2626
2627### Fixed
2628- Automatic `DateAxis` interval detection improved.
2629
2630
2631## [4.0.5] - 2018-12-06
2632
2633### Changed
2634- `DateFormatter` will now automatically format "negative" year values to "BC" (era) format. So not `"-1000"`, but `"1000BC"`. These are translatable via language.
2635- `DropShadowFilter` of the tooltip removed. Instead it is now applied on background of tooltip. This helps to avoid text distortion.
2636
2637### Fixed
2638- Heat rules were not working if all the values were the same. Now middle value between min and max is applied in this case.
2639- Updated algorithm to deal with date axes breaks. It's faster now and does not cause stackoverflow if the gaps are very big.
2640- Series on `HeatMap` charts were ignoring scrollbars.
2641- `DateAxis` was not properly placing labels if `location > 0` and grid interval was bigger than one time unit.
2642- `DateAxis` with very big date difference (thousands of years) displayed too many grid/labels/ticks.
2643- Masking of a sprite with a container updated. It now pays proper attention to container's position.
2644- Automatic `DateAxis` interval detection improved. Previously it detected intervals like minutes, hours, days, years. Now it will detect intervals like 15 min, 30 min, 5 days etc. This can still be set manually using axis' `baseInterval` property.
2645
2646
2647## [4.0.4] - 2018-12-03
2648
2649### Added
2650- `zoomLevel` and `zoomGeoPoint` properties added to `MapSeriesDataItem` and `IMapSeriesDataFields`. If set, these settings instead of automatically-calculated will be used when `zoomToMapObject()` method is invoked.
2651
2652### Changed
2653- `verticalCenter` and `horizontalCenter` is no longer applied to rotated axis labels. If you are setting `rotation` on axis labels, make sure to adjust these settings as well as per your requirement.
2654
2655### Fixed
2656- Setting `axis.renderer.inside` was ignored if set after chart was already initialized.
2657- Changing `align` of the a sprite was ignored if set after it was already initialized.
2658- Top level `TreeMap` segment tooltip was positioned incorrectly after drilling down and back up.
2659- `min`/`max` of `ValueAxis` was not being updated after `invalidateRawData()` call, and series were stacked.
2660- Tooltip sometimes was pointing outside chart container.
2661- `ChordLink` bullets were not properly positioned on init.
2662- `DateAxis` was not working well if `baseInterval.count > 1`.
2663
2664
2665## [4.0.3] - 2018-11-30
2666
2667### Added
2668- Ability to set default locale via `am4core.options.defaultLocale`. When set, all new charts will automatically assume that locale, freeing you from setting locale for each chart individually.
2669- `reverseOrder` added to `Container`. Allows reversing order of its `children`.
2670
2671### Changed
2672- Moved `Legend` of a `MapChart` from `chartAndLegendContainer` to `chartContainer`. In order to position legend on map chart, use `legend.align` / `legend.valign` properties.
2673- Default value of `showOnInit` on any `Series` is now `false`. Except if you are using "animated" theme, which sets it to `true` by default.
2674
2675### Fixed
2676- JSON: Using `type: "Sprite"` in JSON config was not creating elements properly.
2677- Initial chart rendering optimized Charts should build faster.
2678- Some more performance optimizations.
2679- Setting `hiddenInLegend` on `Series` after chart was already built had no effect.
2680
2681
2682## [4.0.2] - 2018-11-28
2683
2684### Added
2685- New method `setInterval()` on all base objects added. Works exactly like JS's `setInterval` but is automatically killed when target object is disposed.
2686- Added array utilities to `am4core`.
2687
2688### Changed
2689- Removed unused `"label"` adapter from `Axis`.
2690
2691### Fixed
2692- [Issue 588.](https://github.com/amcharts/amcharts4/issues/588)
2693- Fixed mouse wheel and zoom control zooming of a map which does not occupies all the div size.
2694- Fixed map scaling issues of a map which does not occupies all the div size.
2695- Sometimes axis labels were not formatted using number or other formatters.
2696- Adapters of data items were not being copied to clones.
2697- `text` property of `AxisDataItem` was not being copied to clones.
2698
2699
2700## [4.0.1] - 2018-11-24
2701
2702### Fixed
2703- Issues with stacked series and `min`/`max` of `ValueAxis` fixed.
2704- Chart cursor now dispatches `"panning"` event only if moved by at least 3 pixels. This solves problem with panning on click.
2705- If `extraMin`/`extraMax` were set on `ValueAxis`, some unnecessary zoom used to happen.
2706
2707
2708## [4.0.0] - 2018-11-22
2709
2710### Changed
2711- Droping BETA tag!
2712- `DropShadowFilter` will now always use balck by default instead of `"alternativeBackground"` from the theme.
2713
2714### Fixed
2715- Setting `hiddenInLegend = true` on Series was causing the chart to hang.
2716
2717
2718## [4.0.0-beta.87] - 2018-11-22
2719
2720### Added
2721- Full source code for amCharts 4 is now included under `/src/`.
2722
2723### Changed
2724- Full language files are now under `/src/lang/`. If you need to make a translation, do a PR on those files/dir.
2725
2726
2727## [4.0.0-beta.86] - 2018-11-20
2728
2729### Fixed
2730- In some situations waiting for `"ready"` event was producing unnecessary frame requests.
2731
2732
2733## [4.0.0-beta.85] - 2018-11-20
2734
2735### Added
2736- `"ready"` event added to `Sprite`. Sprite fires it right after `"init"` event. `Container` fires it when all of its children are ready.
2737- `system.isPaused` property added. Setting it to `true` will effectively pause any chart activity, making them completely static.
2738- `ErrorBullet` class added. Allows drawing error charts. (Check `error-chart` and `xy-error-chart` examples for code samples)
2739- JSON: String-based `cursorOverStyle` and `cursorDownStyle` are not supported.
2740
2741### Fixed
2742- JSON: Setting `ColorSet` properties `baseColor` or `list` was not working properly.
2743- Accessibility: Legend item was not properly referring to a Series via `labelled-by`.
2744- `Label.wrap` was breaking lines mid-word even if there where words that would fit into alotted space.
2745- Memory leak fixed.
2746- Sometimes `Animation` was not firing `"animationended"` event (when elastic easing was used).
2747
2748
2749## [4.0.0-beta.84] - 2018-11-18
2750
2751### Added
2752- `exportable` (default `true`) property added to `Sprite`. If set to `true` this element will not appear in the exported image of the chart.
2753
2754### Changed
2755- `exportable` is now set to `false` by default on `Scrollbar` grips, zoom out button.
2756
2757### Fixed
2758- JSON: `dateFormats` was being ignored.
2759
2760
2761## [4.0.0-beta.83] - 2018-11-15
2762
2763### Added
2764- [`hideOverflow`](https://www.amcharts.com/docs/v4/reference/svgcontainer/#hideOverflow_property) added to `SVGContainer` class. If set to `true` it will apply `overflow: hidden` to chart container so that all chart elements are contained within. Default is `false`, except on `MapChart`, which has it at `true`.
2765
2766### Fixed
2767- Some adjustments and fixes to animations associated with `hide()`/`show()` functions.
2768- If a legend was initially disabled, it was not appearing when enabled later.
2769- `chart.addData()` was not adding data to `XYChart` scrollbar series.
2770
2771
2772## [4.0.0-beta.82] - 2018-11-14
2773
2774### Added
2775- JSON: `forceCreate` property added. If found in an item of an array, it will force creation of the new object, even if object with same index already exists in target `List`.
2776- French locale.
2777
2778### Changed
2779- Adjusted animation durations in "animated" theme.
2780
2781### Fixed
2782- JSON: String-based percent and color values were not being parsed correctly in some cases.
2783- JSON: `HeatLegend` was erroring if its `series` property was referencing to Series by id.
2784- Disposing an item with a custom `id` set was not clearing it from id map properly resulting in errors if item with the same id was being added later.
2785- `SankeyDiagram` was not taking chart's padding into account when sizing itself.
2786- Axis ticks were not being positioned properly after data update.
2787- Map using `deltaLongitude` was being positioned incorrectly.
2788- 3D columns z-indexing was sometimes incorrect.
2789- `PieChart` label placement with custom `startAngle`/`endAngle` was sometimes off.
2790- Label bullets on columns were not being restored from truncated state when width of the columns was increasing.
2791- Series `show()`/`hide()` were using `interpolationDuration` setting instead of `defaultState`/`hiddenState` transition duration when showing/hiding.
2792
2793
2794## [4.0.0-beta.81] - 2018-11-13
2795
2796### Fixed
2797- `chart.hiddenState.properties.opacity` is no longer set to `1` by default. Removed this in order it to be `0` so that charts using animated theme would always fade-in.
2798- Better initial rendering of `ValueAxis` (removed unneeded animations).
2799- Sometimes map was not positioning itself at `homeGeoPoint`.
2800- Map with Eckert6 projection in some cases was not displayed properly.
2801
2802
2803## [4.0.0-beta.80] - 2018-11-13
2804
2805### Fixed
2806- Legend in external container was resulting in infinite loop.
2807- Rendering an arrow on a `MapLine` with same source and destination point was resulting in error.
2808
2809## [4.0.0-beta.79] - 2018-11-12
2810
2811### Fixed
2812- `goHome()` on `MapChart` was not working properly.
2813- `projection` change on `MapChart` was not working properly.
2814
2815
2816## [4.0.0-beta.78] - 2018-11-11
2817
2818### Changed
2819- `DataParser` property `type` was renamed to `contentType` in order not to conincide with JSON-based config built-in keyword `type`.
2820
2821### Fixed
2822- Some rendering issues fixed.
2823
2824
2825## [4.0.0-beta.77] - 2018-11-10
2826
2827### Fixed
2828- Removed console debug (yes, again).
2829
2830
2831## [4.0.0-beta.76] - 2018-11-10
2832
2833### Fixed
2834- Removed console debug.
2835
2836
2837## [4.0.0-beta.75] - 2018-11-10
2838
2839### Added
2840- You can now use `"{percent}"` placeholder in `tooltipText` of `HeatMapSeries` items.
2841
2842### Fixed
2843- Draggable/trackable areas of the chart were intercepting all mouse buttons, including right and back/forward.
2844- Fixed `MapChart` issue with dragging map by touch on hybrid devices.
2845
2846
2847## [4.0.0-beta.74] - 2018-11-08
2848
2849### Fixed
2850- `ColumnSeries3D` were broken since last release.
2851
2852
2853## [4.0.0-beta.73] - 2018-11-07
2854
2855### Changed
2856- `axisFills.template.interactionsEnabled` is now set to `false` by default. If you need to attach events on an axis fill, you will need to set it to `true`.
2857
2858### Added
2859- `autoDispose` property added to `Series` and `Axis` classes with default value `true`. This means that series/axis will be automatically disposed when removed from chart's `series`, `xAxes`, or `yAxes` lists.
2860- It is now possible to have 3D stacked columns (by setting `clustered = false` on series).
2861
2862### Fixed
2863- If chart container was moved in DOM tree, it stopped sensing resize and was not updating its size anymore.
2864- Sometimes `ValueAxis` could show zero label with a minus sign.
2865- Arrows on `MapLine` were not drawn.
2866- It was not possible to change the text color of the tooltip on `TreeMap` diagram.
2867- `axis.tooltipPosition = "pointer"` was not working as it should - always follow the mouse/pointer.
2868- If series had `data` set directly, it was still using chart's global `data`, resulting in combined datasets and potentially visual anomalies.
2869- Setting `cellStartLocation` did not have any effect on an already inited chart.
2870- Line series could be cut off in the beginning (when zoomed-in closely).
2871- Vertical axis ticks were not being positioned properly if axis had a title.
2872- 3D columns were not using chart's `depth`/`angle`.
2873
2874
2875## [4.0.0-beta.72] - 2018-11-03
2876
2877### Changed
2878- For any `XYSeries` if the `itemReaderText` is not set explicitly, it will automatically try to fill with values from `dataFields`, so that each series element, like a Column has at least rudimentary screen-reader text.
2879
2880### Fixed
2881- Added in TypeScript 3.x support.
2882- `ColumnSeries` with two category axes anomaly fixed.
2883
2884
2885## [4.0.0-beta.71] - 2018-11-01
2886
2887### Fixed
2888- Calling `dispose()` on a `TreeMap` was causing an error.
2889- Legend items were being duplicated every time its disabled property was reset back to `false`.
2890
2891
2892## [4.0.0-beta.70] - 2018-10-31
2893
2894### Fixed
2895- Keyboard dragging of elements such as scrollbar grips was not working.
2896- "hoverable" elements were not staying "hovered" after tap in Mobile Safari.
2897- `addData()` with more than one data item added was not working well.
2898- Zoomout button was visible on initial animation.
2899- Dynamically changing `Legend.position` was not updating its layout properly.
2900- Vertical axis tick position with rotated labels was incorrect.
2901
2902
2903## [4.0.0-beta.69] - 2018-10-30
2904
2905### Fixed
2906- Some charts were not properly displayed if initialized in a hidden (`display: none`) container, then revealed (`display: block`).
2907- Last slice of the `PyramidSeries` was not visible for certain widths.
2908- Adding `Legend` to a chart that had series with bullets using heatrules was causing an error.
2909- Label rotation was being ignored on `SlicedChart`.
2910- Labels of `PyramidSeries` were not centered (when `alignLabels = false`).
2911- Animation of labels for horizontal `PictorialSeries` was very jumpy.
2912- `position` and `rotation` of labels in `PyramidSeries` was not working properly.
2913- An error was occurring if chart's with a category axis data was updated and it contained less data points than before.
2914
2915
2916## [4.0.0-beta.68] - 2018-10-30
2917
2918### Changed
2919- `tooltip.defaultState.transitionDuration` and `tooltip.hiddenState.transitionDuration` default values of animated theme set to `400`.
2920
2921### Fixed
2922- Chart was not being drawn properly when instantiated in a hiden container.
2923
2924
2925## [4.0.0-beta.67] - 2018-10-29
2926
2927### Fixed
2928- Chart `Cursor` was preventing hovers on series' elements like columns or bullets.
2929- Mouse cursor's down styles (like on scrollbar) were not being reset back properly in some cases.
2930
2931
2932## [4.0.0-beta.66] - 2018-10-28
2933
2934### Fixed
2935- Axis glitches in `XYChart3D`.
2936- `XYCursor` movement issues.
2937
2938
2939## [4.0.0-beta.65] - 2018-10-28
2940
2941### Changed
2942- `tooltip.hiddenState.transtionDuration` and `tooltip.defaultState.transitionDuration` are now set to 1 (on non-animated theme) to avoid some tooltip flickering.
2943- Individual legend items (label, value label, and marker) now have their `interactionsEnabled = false` set by default to avoid double events. If you need to add events to these particular elements (as opposed to the whole legend item), you will need to set `interactionsEnabled = true` on that element.
2944
2945### Fixed
2946- Calling `show()` on a `MapSeries` object was resulting in an error.
2947- 3D columns were not visible if their value was zero.
2948- Bullets are now hidden if `minBulletDistance` is set.
2949
2950
2951## [4.0.0-beta.64] - 2018-10-27
2952
2953### Added
2954- `shouldClone` flag added to `EventDispatcher`'s `on` and `once` methods. Can be used to restrict cloning of events when object itself is cloned.
2955- [`showOnInit`](https://www.amcharts.com/docs/v4/reference/sprite/#showOnInit_property) property added to `Sprite`. If this is set to `true`, the `Sprite`, when inited will be instantly hidden ("hidden" state applied) and then shown (animate properties form "hidden" state to "default" state). Animation will take `defaultState.transitionDuration`. `Series`, `Chart` classes has this set to `true`, so that they would perform initial animations. If you want a sprite (chart, series) not to be shown initially, you can set Sprite's [`hidden`](https://www.amcharts.com/docs/v4/reference/sprite/#hidden_property) to `true`. (`setting sprite.visible = true` won't work as expected anymore).
2956
2957### Changed
2958- If chart rendering takes too long, it now is split into chunks, which makes the browser/page remain responsive even if you have a lot of charts to build.
2959- Changed how pre-hiding Series works. If you want series to be initially hidden, use `series.hidden = true` instead of `series.visible = false`.
2960- Removed `"hold"` and `"rotate"` interaction events and releated options and functionality, since they weren't used anywhere.
2961- Removed `"delayFirstHit"` option from `Sprite.hitOptions`.
2962- `chart.defaultState.transitionDuration` is set to `1`. This allows the chart to appear one frame after init and helps to avoid various flickers that happen while chart is building. Animated theme has this value set to `2000`.
2963
2964### Fixed
2965- Performance enhancements.
2966- Non-draggable/trackable but otherwise interactive elements of the chart no longer prevent scrolling and other gestures on touch screens.
2967- `PieSeries` labels sometimes were positioned incorrectly (using non-default start/end angles).
2968- Slices (also columns of `RadarChart`) were not drawn if `radius <= 0` (even if `innerRadius > 0`). This resulted in radar columns not rendered in some cases.
2969- `MapChart` was not resizing properly when div size changed.
2970- `PictorialStackedSeries`, while `containerdiv` was resized did flicker a lot.
2971- If a Tooltip is visible while its Sprite changes size/position, it updates its position as well.
2972- Setting `chart.data = []` was not clearing data properly.
2973
2974
2975## [4.0.0-beta.63] - 2018-10-20
2976
2977### Fixed
2978- In some cases a `PieChart` could overlap its legend.
2979- `PieChart` flicker after `invalidateData` fixed.
2980- An error was occurring when data was updated on chart with series with bullet while hovering it with cursor.
2981
2982
2983## [4.0.0-beta.62] - 2018-10-19
2984
2985### Fixed
2986- Tooltip issue fixed.
2987
2988## [4.0.0-beta.61] - 2018-10-19
2989
2990### Changed
2991- If element has `url` set, when clicked, it will now parse for data placeholders in curcly brackets, e.g. `"{category}"` allowing have dynamic data-driven URLs. Note, the elements are not url-encoded so you need to specify encoding manually, e.g.: `series.columns.template.url = "https://www.google.com/search?q={category.urlEncode()}";`.
2992
2993### Fixed
2994- `Label.fullWords = false` was not working properly.
2995- `AxisLabelCircular` was positioning labels incorrectly, if label.radius was negative (since 59).
2996- `"grid"` layout in `Container` was incorrectly layouting elements if their `width` was set in percent.
2997- [IE] Multi-line truncated labels were not working properly on IE.
2998- [IE] was incorrectly zIndexing elemens (since version 56).
2999- [IE] tooltip initial flicker solved.
3000- [IE] was incorrectly sorting multiple series tooltips (if `Cursor` was used).
3001
3002
3003## [4.0.0-beta.60] - 2018-10-18
3004
3005### Changed
3006- `"hidden"` data field added to series' `dataFields`. Removed `"visible"` data field from `PercentSeries`. You should use `"hidden"` data field to set which slices/columns/etc. are hidden initally.
3007- `AxisLabelCircular`'s `radius` can now be set in `Percent`. `PieChart`'s label radius default value was set to `5%`.
3008
3009### Fixed
3010- Multi-line labels were not being aligned properly in IEs.
3011- In some cases, `fillModifier` was not applied if set after `fill`.
3012- In some cases, a chart with `seriesContainer` disabled, or when `seriesContainer`'s height/width was 0, could produce a JS error.
3013- Some performance tuneups, especially for charts with axes and more data.
3014
3015
3016## [4.0.0-beta.59] - 2018-10-17
3017
3018### Added
3019- [`widthRatio`](https://www.amcharts.com/docs/v4/reference/image/#widthRatio_property) and [`heightRatio`](https://www.amcharts.com/docs/v4/reference/image/#heightRatio_property) properties on `Image`.
3020
3021### Fixed
3022- Some adapters for Axis elements were being applied twice.
3023
3024
3025## [4.0.0-beta.58] - 2018-10-17
3026
3027### Added
3028- `ExportMenu`'s "custom" items can now have `"callback"` which is a function to call when clicked on such custom item.
3029
3030### Changed
3031- Slice labels on a `PieChart` now move with the slice (if `alignLables = false`).
3032
3033### Fixed
3034- `requestAnimationFrame` now is called only when needed. This reduces idle CPU usage.
3035- Fixed `m4core.color()` result caching issue.
3036- Charts were broken in IEs since beta.57.
3037- `Tooltip` on `LineSeries` was not updating color if segment changed color.
3038- `MapChart` without any series was displaying an error in console.
3039- Axis tooltip was trimmed when `renderer.inside = true`.
3040- `StepLineSeries` `startLocation`/`endLocation` bug fixed.
3041- `"hover"` state was not being applied to series' bullet if it did not hav `tooltipText` set.
3042- `bulletLocation` for horizontal `ColumnSeries` fixed.
3043- Value labels of `Legend` were not in correct positions if `Legend` was positioned at the top or bottom (too close to legend label).
3044
3045
3046## [4.0.0-beta.57] - 2018-10-15
3047
3048### Changed
3049- All charts (that inherit from `Chart`) now will apply "hidden" state right after they are validated, then immediately "default" state. This allows creating initial animations such as fade-in (if using animated theme). All you need to do is set: `chart.hiddenState.properties.opacity = 0;`.
3050
3051### Fixed
3052- Mouse wheel zoom was broken since beta.56 on `MapChart`.
3053- Pushing `Sprite` to `Container.children` directly (instead of setting parent) used to produce a JS error.
3054
3055
3056## [4.0.0-beta.56] - 2018-10-12
3057
3058### Added
3059- New `Sprite` adapter: `"populateString"`. Applied to strings after `Sprite` replaces data binders with real values, but before any formatting by `Label` kicks in.
3060- New `Label` property: [`ignoreFormatting`](https://www.amcharts.com/docs/v4/reference/label/#ignoreFormatting_property). If set to `true` will treat formatting blocks in square brackes (e.g. `"[red bold]"`) as regular text and will display them as such.
3061
3062### Changed
3063- Default big, small, and byte suffixes in `NumberFormatter` are now translatable via locale files.
3064- The suffix for thousands "kilo", was changed to lowercase "k", as per [standards](https://en.wikipedia.org/wiki/International_System_of_Units#Prefixes).
3065- On `XYChart`, default for [`mouseWheelBehavior`](https://www.amcharts.com/docs/v4/reference/xychart/#mouseWheelBehavior_property) changed to `"none"` (was `"zoomX"`).
3066
3067### Fixed
3068- Improved performance! All charts types are now noticably, some drastically are faster. Some memory leakages fixed as well.
3069- Now `MapPolygonSeries` will not inherit chart's global `geodata` if it has own `geodataSource` set.
3070- `DateFormatter` was not parsing all AM/PM string dates correctly.
3071- `DateFormatter` was not parsing `MMM` (short month names like "Jan", "Feb") propertly.
3072- In-line date formatter was not working correctly in some cases, e.g. `"{dateX.formatDate()}"`.
3073- Setting `chart.mouseWheelBehavior = "none"` did not release wheel scrolling of the web page when hovering over chart.
3074- `DataSource`'s' `"done"` event was being called if parsing of loaded data failed. Not anymore. `"done"` is called only on successful load. To catch any load (including one that ended in http or parse error) use `"ended"`.
3075- `DataSource`'s' `reloadFrequency` was broken if error occurred during one of the loads. This has been fixed. Even if error occurrs, loader will try to reload data in the next reload slot.
3076- JSON: `heatRules` did not work properly with their target set to a list template, e.g. `mapPolygons.template`.
3077- Auto-calculated `DateAxis.baseInterval` was not being carried over to the `XYChartScrollbar`.
3078- `DurationAxis` scale sometimes was dropping to negative values, even there were no negative values in data.
3079- `PieChart` and `Legend` were not working properly with `chart.zoom()` or `legend.zoom()` methods.
3080
3081
3082## [4.0.0-beta.55] - 2018-09-26
3083
3084### Added
3085- New series type suitable for `SlicedChart`: `PictorialStackedSeries`. (check `pictorial-stacked-chart` and `pictorial-stacked-chart-horizontal` demos)
3086- New themes: "dataviz", "moorisekingdom", "frozen", "spiritedaway".
3087- New Chart property: `logo`. If you are using amCharts with a free license, it holds reference to amCharts logo. Use it to position logo with `align` and `valign` properties.
3088- New `FunnelTick` properties: `locationX` and `locationY`. Allow specifying a relative location within target element where tick is pointing to.
3089
3090### Changed
3091- `FunnelChart` was renamed to `SlicedChart`. The previous name did not correctly represent capabilities of the chart type that can display not only funnel series, but also pyramids and stacked pictorial series. `FunnelSeries` remains as it was before.
3092
3093### Fixed
3094- Mouse wheel zoom was extremely slow in FireFox.
3095- Sometimes colors duplicate colors were generated by `ColorSet`.
3096- HTML-based labels were not accounting for "pixel ratio" on Retina displays, making tooltips larger then they are supposed to be.
3097
3098
3099## [4.0.0-beta.54] - 2018-09-22
3100
3101### Fixed
3102- Chart Cursor was working only for the first chart on the same page.
3103- `CSVParser` was not parsing `dateFields` and `numberFields` correctly.
3104- Issues with labels rendering in incorrect position fixed.
3105- `LinearGradientModifier` was not copying gradient properties to clones (since last version only).
3106- `FunnelSlice` sometimes rendered slice edges with no anti-aliasing.
3107- When calculating area of the Pyramid slices height of `sliceConnector` was not being taken into account.
3108- Reset `label.renderingFrequency` back to `1` to solve some unwanted label flickering.
3109- `MapImage` items were not showing if added via `series.data` (since last version only).
3110
3111
3112## [4.0.0-beta.53] - 2018-09-21
3113
3114### Added
3115- New property `durationFormat` on `DurationFormatter`. If set, it will force this format to be used, instead of one determined by `baseUnit`.
3116
3117
3118## [4.0.0-beta.52] - 2018-09-21
3119
3120### Added
3121- `CurvedColumnSeries` added. Allows having columns as curves or as triangles. Check `curved-column-chart` and `triangle-column-chart` in examples folder.
3122- `RadialGradientModifier` class added. Allows building more donut-like pie charts. Check `semi-circle-donut-chart` in examples.
3123- New chart type: `FunnelChart`, which can show regular FunnelSeries and PyramidSeries.
3124- New axis type: `DurationAxis`. Values on it are treated and formatted like time durations.
3125- `extraMin` and `extraMax` properties added to `ValueAxis`. Can be used to relatively adjust calculated minimum and maximum scale values.
3126- Two new read-only properties added to `Container`: `contentWidth` and `contentHeight`. Will hold width/height in pixels of the actual dimensions of elements in Container.
3127
3128### Changed
3129- `DurationFormatter` now uses `TimeUnit` for its `baseUnit`, rather than arbitrary codes.
3130- `durationFormat` property was removed from `DurationFormatter`. Use [`getFormat()`](https://www.amcharts.com/docs/v4/reference/durationformatter/#getFormat_method) method to get correct format instead, then pass in to `format()`.
3131- Series will not show a tooltip (if one axis is `CategoryAxis`) if there is no value for this category (used to show tooltip if it had some extra text).
3132
3133### Fixed
3134- Legend `valueLabel` values were not shown on chart initial render.
3135- 3D pie slices were not showing full stroke, only on the upper part of a slice.
3136- Sometimes `XYChart` did some additional animation even after all series finished animating, causing zoom-out flashing briefly.
3137- `XYChartScrollbar` was not showing series if data to the original series was added later (or changed).
3138- Chrome was not showing line series in `XYChartScrollbar` if all values were equal.
3139- Creating an empty line (without `multiGeoLine` set) was resulting in critical error.
3140
3141
3142## [4.0.0-beta.51] - 2018-09-13
3143
3144### Changed
3145- Changed `Label.renderingFrequency` to `2`, for better performance.
3146
3147### Fixed
3148- Performance tweaking.
3149- `DateAxis.baseInterval` was ignored in JSON-based configs.
3150- `"hoverActive"` state was not always being correctly applied.
3151- Better handling of cursor zoom and pan when outside chart area.
3152- Fixed occasional error when formatting dates or numbers.
3153- Line chart starts new segement only if properties (like `stroke`, `fill`, `strokeDashArray`, etc.) in data have changed. It used to start new segment if properties in data were defined resulting in reduced performance and disabled smoothed lines.
3154- Labels were not updating their position if their `fontSize` changed.
3155- `Sprite.nonScalingStroke = true` was ignored if set after `Sprite.strokeWidth`.
3156- `LineSeries` could leave some garbage lines while zooming.
3157- `ColumnSeries` could leave some garbage columns while zooming.
3158- `DateAxis` with one date only in chart data was not rendered properly.
3159- The chart was not zooming out after data validation.
3160- Added `ghostLabel` to `Axis` which is an invisible label and it helps to avoid unwanted changes of axis widht/height when the scale changes, e.g. on zoom.
3161- `zoomToMapObject`, if used with `MapPolygon` and custom `zoomLevel` was not working properly.
3162- `"hidden"` event of Series was called on initial chart initialization.
3163
3164
3165## [4.0.0-beta.50] - 2018-09-10
3166
3167### Added
3168- `am4core.unuseAllThemes()` method added. Any chart created after this method call will not have any theme applied to it.
3169- New property `am4core.registry.baseSprites` will now hold all active (non-disposed) instances of top-level elements, such as charts.
3170- `startLocation`/`endLocation` properties added to `CategoryAxis` (previously available on `DateAxis` only). Allows to specify location the first and last cells of the axis should start on respectively.
3171- `innerRadius` of a Slice can now be set as `Percent` (e.g. `am4core.percent(50)`).
3172- You can now set custom radii (`radius` property) on Pie series (if you have more than one, you might want one to be larger and another smaller).
3173
3174### Changed
3175- [`MapLine.imagesToConnect`](https://www.amcharts.com/docs/v4/reference/mapline/#imagesToConnect_property) now accepts an array of string IDs that can reference images by their `id` property.
3176- Changed `tooltip` inheritance so that it checks for `virtualParent` rather than direct `parent`. E.g. series' bullets use series' tooltip and not chart tooltip as it was before.
3177
3178### Fixed
3179- Map polygon stroke thickness could be rendered incorrectly when zooming quickly. (Issue #175)
3180- Calling `addData()` more than once before data was validated resulted only last data item to be added. (Issue #222)
3181- `DateAxis.baseInterval` was ignored if data was set directly on series.
3182- `MapLine` was not paying attention to the properties set on template.
3183- `HeatLegend` was not updating its label count after its size changed. This could have been resulting in very few labels if initial container (div) size was small.
3184- The map portion of `MapChart` was incorrectly positioned after container (div) resize.
3185- Object properties, like `"name"` in GeoJSON were overriding same properties in `MapSeries` data. Now, the values specified in data are used over ones in GeoJSON. (Issue #307)
3186- Axis ranges used to reset `axisRange.label.text`. (Issue #308)
3187- Fixed issues with disposing series and charts.
3188- Updated to [canvg 1.5.3](https://github.com/canvg/canvg/releases/tag/v1.5.3) to fix em/rem text issue for epoxrt fallbacks.
3189
3190
3191## [4.0.0-beta.49] - 2018-09-05
3192
3193### Added
3194- JSON config: added `callback` property, which if it holds a reference to function will call it within the scope of the object being prepared.
3195- Adapters for `url` and `urlTarget` properties.
3196- Chart can now be panned or zoomed using mouse wheel. To set what it does use `mouseWheelBehavior` on `XYChart` (see next point)
3197- [`mouseWheelBehavior`](https://www.amcharts.com/docs/v4/reference/xychart/#mouseWheelBehavior_property) added to `XYChart`. Options: `"zoomX"` (default), `"zoomY"`, `"zoomXY"`, `"panX"`, `"panY"`, `"panXY"`, `"none"`.
3198- [`mouseWheelBehavior`](https://www.amcharts.com/docs/v4/reference/mapchart/#mouseWheelBehavior_property) added to `MapChart`. Options: `"zoom"` (default), `"none"`.
3199
3200### Changed
3201- Second parameter to `Cursor`'s [`triggerMove()`](https://www.amcharts.com/docs/v4/reference/cursor/#triggerMove_method) method was changed from boolean to enumeration of "stickiness" level: `"hard"`, `"soft"`, `"none"` (default).
3202
3203### Fixed
3204- Error fixed when `Popup` object was being disposed.
3205- Over-panning of an `XYChart` did not disappear after mouse button was released outside chart.
3206- Multiple memory leaks fixed.
3207- `MapChart` was rounding lat/long coordinates too much which was resulting in pixelated maps for small-area maps.
3208
3209
3210## [4.0.0-beta.48] - 2018-08-31
3211
3212### Added
3213- `useWebFonts` setting in `Export`. Allows disabling of download of web fonts when exporting.
3214- `useRetina` setting in `Export`. Images are now exported scaled up on retina displays by default. Set `useRetina = false` to disable.
3215
3216### Changed
3217- Export fallback mechanism for older browsers changed from FabricJS to canvg, which is much lighter and has better text formatting support.
3218- On retina displays images will now export supersized in order not to lose quality. Set `useRetina = false` to disable.
3219- amCharts logo will now auto-hide on supersmall chart sizes.
3220
3221### Fixed
3222- Cursor was zooming the chart even if drag motion was performed on an external element positioned over the chart.
3223- Cursor was not hidden when it was no longer hovering the chart area if chart had no padding.
3224- `urlTarget` was not carried over from `ListTemplate` template to new items.
3225- Cursor could cause chart to freeze up on a DateAxis with empty cells in the axis' beginning or end.
3226- Export will now correctly handle web fonts, such as Google Fonts. Please note that FontAwesome is not supported, since they forbit any kind of usage, except inclusion via CSS.
3227
3228
3229## [4.0.0-beta.47] - 2018-08-24
3230
3231### Added
3232- New series type: `OHLCSeries`.
3233- `goHome()` method added to `MapChart`. Calling it will reset map to `homeZoomLevel` and `homeGeoPoint`.
3234- `homeGeoPoint` added to `MapChart`. Allows setting initial `geoPoint` at which map will be centered.
3235- `homeZoomLevel` added to `MapChart`. Allows setting initial `zoomLevel`.
3236- `maxPanOut` property added to `MapChart`, with default value `0.7`. It prevents map to be dragged out of the chart area.
3237- `noRisers` property added to `StepLineSeries`. It allows step line chart without vertical (or horizontal, depending on orientation) lines.
3238- Step line without risers now allows making Waterfall chart. Example added.
3239- `startLocation` and `endLocation` added to `StepLineSeries`, that allow controling locations at which step should start/end.
3240- `maxPrecision` added for `ValueAxis`. Use it to restrict Value axis to show value labels with less than desired precision (set 0 if you only want integers).
3241- Portugese (Portugal) translation added.
3242
3243### Changed
3244- `Cursor` will now not move if there's some element obstructing the chart's plot area, e.g. a popup or some other element outside the chart.
3245
3246### Fixed
3247- Series' and axes' tooltips will now correctly inherit formatters.
3248- Errors when hovering mouse cursor over open Modal.
3249- JSON: `children` property of `Container`-type objects was not being processed correctly.
3250- Popup/Modal now sets `aria-label` automatically if title is set.
3251- Removing bullet template from series or disposing it will remove/dispose all the bullets created from it.
3252- Tooltips were overlapping each other, fixed for the most part, but might still be some situations where they overlap.
3253- Changing data for `MapImageSeries` and `MapLineSeries` used to result runtime error.
3254
3255
3256## [4.0.0-beta.46] - 2018-08-19
3257
3258### Fixed
3259- `TreeMap.homeText` was not working.
3260- `TreeMap` used to display upper level bullets/labels when drilled-down.
3261- `TreeMap` had issues with hiding items using legend (when not using animated state).
3262- Chart cursor was not visible if data was set directly on axis/series but not on chart.
3263
3264
3265## [4.0.0-beta.45] - 2018-08-17
3266
3267### Added
3268- New hardcoded `Sprite` state name added `"hoverActive"` which (if defined) is applied on active elements on hover. This state is applied last in the chain.
3269- New property on `DataSource`: `keepCount`. If set to `true` incremental updates will remove data items from the beginning of the current dataset, when adding the newly-loaded ones.
3270- New property on `DataSource`: `incrementalParams`. It's an object whose key/value pairs will be added to URL as parameters when DataSource is making an incremental load request.
3271- `Popup` (and `Modal`) now have an event dispatcher (`events`) with two events: `"opened"` and `"closed"`. ([more info](https://www.amcharts.com/docs/v4/concepts/popups-and-modals/#Event_handlers))
3272
3273### Changed
3274- Legend now respects `itemContainers.template.togglable = false`, which disables default functionality of toggling items when clicked in legend, allowing users to attach their own funcitonality to legend item clicks.
3275- Toggling of items in Legend can now be disabled by setting `chart.legend.itemContainers.template.togglable = false`.
3276- In `XYChart` with a `DateAxis`, cursor and data at irregular intervals will now display a Tooltip for nearest available series' data item.
3277- `zoomToCategories` method of `CategoryAxis` now zooms to the end of the "to" category.
3278- Default `urlTarget` of amCharts logo is now `"_blank"`.
3279
3280### Fixed
3281- In `DataSource` the formatters `inputDateFormat` was ignored.
3282- Incremental data load via `DataSource` was not working.
3283- Tooltip used to flicker ar 0,0 position in some cases when hovering over elements.
3284- Fixed issue which caused chart to gradually shrink to invisibility under some conditions.
3285- Fixed rendering errors for charts that were initialized in hidden containers.
3286- `XYCursor` lines and axis tooltips were not shown if chart did not have any data (data was set directly on axis/series).
3287
3288
3289## [4.0.0-beta.44] - 2018-08-14
3290
3291### Added
3292- `TreeMap` now supports legend. Legend will be displayed if a) `TreeMap` data is at least two levels deep (legend displays items from a second level); b) `chart.maxLevels` is set to `2` (without setting it no second-level series are created so legend does not have anything to build itself from). [More info](https://www.amcharts.com/docs/v4/chart-types/treemap/#Legend).
3293- Swedish translation.
3294
3295### Changed
3296- `DateFormatter` will now automatically capitalize month/weekday name if it's the first (or only) word in resulting formatted date. This can be turned off by setting formatter's [`capitalize`](https://www.amcharts.com/docs/v4/reference/dateformatter/#capitalize_property) to `false`.
3297
3298### Fixed
3299- Removed `@deprecated` commented out methods/properties that were confusing tslint.
3300- Issue that caused the chart to shrink was fixed.
3301
3302
3303## [4.0.0-beta.43] - 2018-08-12
3304
3305### Changed
3306- `$net.load()` options parameter now supports `responseType`. If set to `"blob"` will return response as `Blob` object in `result.blob`.
3307
3308### Fixed
3309- Value axis min/max calculation algorithm adjusted. Fixed an issue with `strictMinMax = true` and issue with min/max when axis size was very small.
3310- Export now correctly uses external fonts included via `@import`, such as Google Fonts.
3311- Non-clickable columns in `ColumnSeries` will no longer gain focus on click/tap, unless its `hitOptions.noFocus` is set to `false`.
3312- Noon was incorrectly formatted as "AM", instead of "PM".
3313- `TextFormatter` was producing invalid `style` value on empty formatting blocks (`"[]"`).
3314- `parent` was not being set for a `Sprite` that was pushed directly to `Container.children`.
3315- If axis labels were disabled, ranges labels were not visible.
3316- Axis used to reset some of the user-set values when initing renderer, e.g. `dateAxis.renderer.grid.template.location = 0.5` was not working.
3317- `XYChart` with category axis + date axis was not working properly.
3318- Stacked chart with logarithmic axis was not working properly.
3319- JSON: local formatter instances were not being instantiated properly, so all children objects were reusing chart's main formatters.
3320- JSON: Patterns are now supported.
3321
3322
3323## [4.0.0-beta.42] - 2018-08-05
3324
3325### Fixed
3326- Updated default Popup CSS to eliminate a rare scrollbar flashing issue.
3327- Fixed an error with PDF exporting.
3328
3329## [4.0.0-beta.41] - 2018-08-03
3330
3331### Added
3332- `MapSeries` now has `geodata` and `geodataSource`. This allows setting separate maps to each separate map series, which no longer rely on single chart-wide `geodata`. Also, setting `geodata` for `MapSeries` will automatically set `useGeodata = true`, so no need to set it manually.
3333
3334### Changed
3335- Removed unused `boldUnitChange` from `DateAxis`.
3336- Labels on `DateAxis` will now pay attention to `label.location` if label represents full time period between grids. It no longer will force labels to be in the middle.
3337- `label.currentText` is now public.
3338
3339### Fixed
3340- Fixed parsing of string dates in ISO format (`"i"`).
3341- Legend marker was not aligned with the text (when marker was smaller).
3342- Solved legend error which happens if you show/hide series after series was added/removed.
3343- Dynamically adding series was not automatically adjusting axis scales.
3344- Vertical `CategoryAxis` was not paying attention to `grid.location`.
3345- Map issues at `minZoomLevel < 1` fixed.
3346
3347
3348## [4.0.0-beta.40] - 2018-08-02
3349
3350### Added
3351- German translation. (de_DE)
3352
3353### Changed
3354- [`XYChart.getUpdatedRange()`](https://www.amcharts.com/docs/v4/reference/xychart/#getUpdatedRange_method) method is now public so you can use it to recalculate absolute axis range into a relative that takes current zoom and inversion into account.
3355- `Language` now supports `null` in translations which means an empty string.
3356- Interface `iColorSetStepOptions` was renamed to `IColorSetStepOptions` to maintain consistency.
3357- Interface `ColorPurpose` was renamed to `IColorPurpose` to maintain consistency.
3358- `FlowDiagramNode` `value` property renamed to `total`, added `totalIncoming` and `totalOutgoing` properties which hold sum of all incoming/outgoing links.
3359- Removed aliases `startCategory`, `startValue`, and `startDate` from Axes data items. (use `category`, `value`, and `date` respectively)
3360
3361### Fixed
3362- Improved performance of Sankey/Chord Diagrams.
3363- Elements of `TreeMapChart` were not respecting locale.
3364- Fixed-height bars were drawn incorrectly.
3365- Pre-hidden series were not taken into account when calculating min/max of value axes in some cases.
3366- Setting chart data with less data items then there were before resulted in an error.
3367
3368
3369## [4.0.0-beta.39] - 2018-07-27
3370
3371### Added
3372- `useChartAngles` added to `AxisRendererCircular`. If set to `false` allows to set `startAngle`/`endAngle` to each circular axis individually.
3373
3374### Fixed
3375- Fixed problem with custom `Legend` data and initial visibility, you can now use `visible: false` to pre-hide custom legend items.
3376- Grid Layout fixed, affects Legend.
3377
3378
3379## [4.0.0-beta.38] - 2018-07-26
3380
3381### Fixed
3382- Using `PieSeries` data field `"visible"` was not graying out Legend's marker.
3383
3384
3385## [4.0.0-beta.37] - 2018-07-26
3386
3387### Added
3388- You can now make series initially to be hidden by setting `series.visible = false`.
3389- `visible` added to `PieSeries.dataFields`. It allows making some of the slices initially hidden.
3390
3391### Changed
3392- Sankey/Chord diagrams has now toggling nodes enabled by default. To disable, set `chart.nodes.template.togglable = false`.
3393
3394### Fixed
3395- Text formatter now correctly escapes double square/curly brackets, as well as empty formatting blocks `[]`.
3396- Setting `series.visible = false` or `series.hide()` wasn't toggling off related item in Legend.
3397- Setting `isActive` did not affect `Container`'s background (assuming it had `"active"` state).
3398
3399
3400## [4.0.0-beta.36] - 2018-07-25
3401
3402### Added
3403- `elements` property in `Popup`. Returns an object consisting of references to various elements of the Popup, like content block, close button, etc.
3404
3405### Changed
3406- `am4core.getSystem()` has been changed to `am4core.system`
3407
3408### Fixed
3409- Fixed double "amcharts" in Popup's class names.
3410- Fixed dragging on of absolute-positioned Popups.
3411- Escaping square brackets in text (by repeating them twice) was not working.
3412- Fixed a lot of disposer leaks.
3413- Fixed an issue that caused runtime errors with Rollup.
3414
3415
3416## [4.0.0-beta.35] - 2018-07-23
3417
3418### Added
3419- New adapter on `Component` (and everything that inherits it including charts and series): `"data"`.
3420- New adapter on `Popup`: `"closable"`.
3421
3422### Changed
3423- `showModal()` and `hideModal()` methods were renamed to `openModal()` and `closeModal()` respectively.
3424- `show()` and `hide()` methods on `Popup`/`Modal` were renamed to `open()` and `close()` respectively.
3425
3426### Fixed
3427- More performance-related improvements, especially with `CategoryAxis`.
3428- Changing `interactionsEnabled` from `false` to `true` was not working properly in IE.
3429- Setting `axisRenderer.inside = true` after chart was already built didn't work.
3430- `zoomlevelchanged` event of `MapChart` was being fired even if zoom level did not change.
3431- Setting `MapChart.deltaLongitude` was ignored if it was set before projection was set.
3432- Map tooltip bounds were not being updated when map container's size changed.
3433
3434
3435## [4.0.0-beta.34] - 2018-07-22
3436
3437### Fixed
3438- Dramatic performance improvements!
3439
3440
3441## [4.0.0-beta.33] - 2018-07-19
3442
3443### Added
3444- `calculatePercent` flag added to `Series`. Default value is `false`, except for `PieSeries`. Series will not calculate percent values of each data item if this is not explicitly set to `true`. Since it wasn't been used anywhere but Pie chart, this should improve performance of initial data parsing.
3445
3446### Fixed
3447- Performance improvements. Especially when zooming/scrolling chart with a lot of data.
3448- `lineSeries` was not paying attention to `propertyField` values set in data.
3449- Radar and Gauge charts were not centered properly when resizing window.
3450- Container's background properties were not copied when cloning container.
3451
3452
3453## [4.0.0-beta.32] - 2018-07-17
3454
3455### Important (potentially breaking changes)
3456- To maintain event-naming consistency, events `"insert"` and `"remove"` were renamed to `"inserted"` and `"removed"` respectively in `List` and its inheriting classes. [#132]
3457- To maintain event-naming consistency, events `"clear"` and `"remove"` were renamed to `"cleared"` and `"removed"` respectively in `Dictionary` and its inheriting classes.
3458
3459### Fixed
3460- Significant performance improvements were made.
3461- JSON config: Filters could not be used.
3462- Some properties were not being copied when cloning objects, e.g. `segments` in `LineSeries`. (`interactionsEnabled` and some others)
3463- Circular axis was not properly drawing grid lines if `radius` was < `percent(100)`.
3464- `Button` label was "stealing" interactions from the button itself.
3465- `Tooltip` was sometimes drawn without pointer if "animated" theme was not enabled.
3466- Fixed label alignment of Y axis.
3467
3468### Changed
3469- Improved `contentAlign` (when content size is bigger than actual size of a container).
3470
3471### Added
3472- Two new adapters added to `Label`: `"textOutput"` and `"htmlOutput"`. Both are applied **after** label contents (text or HTML respectively) are populated with data.
3473- Added `"custom"` option to export menu types, which now allows creating clickable custom items in the `ExportMenu`.
3474- `Legend` now accepts "raw" data, enabling creating custom items: `legend.data = [{name:"name 1", fill:"#ff0000"}, {name:"name 2", fill:"#00ff00"}]`. Important: a legend with custom items must be added to some chart container manually (e.g. `chart.chartContainer`). Assigning it to `chart.legend` will overwrite its data.
3475
3476## [4.0.0-beta.31] - 2018-07-06
3477
3478### Important
3479- Layouting mechanism was revamped to make it more consistent and intuitive. If you see some layout issues with your chart, please let us know!
3480
3481### Added
3482- New chart type: [`ChordDiagram`](https://www.amcharts.com/docs/v4/chart-types/chord-diagram/).
3483
3484### Changed
3485- The `Adapter` `keys` property is now a 0-argument function and not a property.
3486- `Adapter` callback now has third parameter `key`, which is a string indentifier of the adapter being applied.
3487- `ChordDiagram`, same as `SankeyDiagram` now extend `FlowDiagram` class. `FlowDiagram` can not be instantiated alone, it's a base class for those two.
3488- `minWidth`/`minHeight` is now set to some small amount on a `PieChart` so that it remains visible even, if the oversized legend does not fit into container.
3489- `heatRules` no longer override properties if they are set using `propertyFields`.
3490
3491### Fixed
3492- Printing in Firefox was broken after latest updates in export/print.
3493- Re-enabled data export on legacy IEs.
3494- If a legend was initially disabled, it did not show up after enabling it later.
3495- Series tooltip was not disposed when series was disposed. This could result in tooltips hanging and not hidin in such charts as `TreeMap` after data was changed.
3496- `Tooltip` was sometimes flickeing at 0,0 position when first hovered on columns of a series.
3497- When all values were 0, `XYChart` was not displayed properly.
3498- When all values were equal and less than 0, `XYChart` was not displayed properly.
3499- Zero-value slices were shown as black rectangles in the pie chart legend.
3500- Labels were not showing tooltips.
3501- `LineSeries` was not displayed properly if colors were set in data. (using `propertyFields`)
3502- Tooltips were shown with white background when first hovered over slices/columns/etc.
3503- Setting `interactionsEnabled = true` did not if it was set to `false` previously.
3504- `axisFill` was not showing `innerRadius` correctly if it was set as `Percent`.
3505- Data update on `SankyDiagram` was resulting in error.
3506
3507## [4.0.0-beta.30] - 2018-06-22
3508
3509### Fixed
3510- JSON config: `heatRules` can now refer to bullets in `tartget` using syntax `"bullets.0.property"`, e.g. `"bullets.0.circle"`. (meaning use "circle" property of the first bullet as heat rule target)
3511- Export: fixed SVG export on Firefox.
3512- Export: fixed SVG/CSV/JSON export for Edge/IE.
3513- Export: fixed sheet name limitations for Excel export.
3514- Export: print option was printing the whole page instead of just chart on IEs.
3515- Export: fixed bitmap image export on IEs.
3516- [Issue 65.](https://github.com/amcharts/amcharts4/issues/65)
3517
3518### Changed
3519- `class` attribute is no longer applied to elements by default. To enable it use new setting `am4core.options.autoSetClassName`.
3520- `class` attributes now will contain the whole inheritance chain, e.g. `"amcharts-Sprite amcharts-Container amcharts-Button"`. Class names are no longer lowercased.
3521- The `svgContainer` property is now an `SVGContainer`, not an `HTMLElement`.
3522
3523### Added
3524- New global option `am4core.options.autoSetClassName` (default `false`). If set to `true` will set `class` attribute of all elements that reflect class element was created in, including inheritance, e.g. `"amcharts-Sprite amcharts-Container amcharts-Button"`.
3525
3526### Removed
3527- Element-level `classNamePrefix` is no longer available. Use global `am4core.options.autoSetClassName` instead.
3528
3529## [4.0.0-beta.29] - 2018-06-16
3530
3531### Fixed
3532- Wrong `Cursor` behavior in Edge browser on hybrid touch screens.
3533- Malfunctioning colors in IE9.
3534- Console errors, triggered by mouse hover in IE9.
3535- A bunch of errors and bugs on Popup/Modal in IE9.
3536- Enabling `ExportMenu` on IEs was breaking the chart.
3537- `"dragstop"` event was not being triggered on touch and hybrid devices.
3538
3539### Changed
3540- Dramatically improved performance of dragging of Popup.
3541- The `dataItem` of the tooltip is now set sooner, which enables it to be used in its various adapters.
3542
3543### Added
3544- `Sprite` now has [`hoverOptions`](https://www.amcharts.com/docs/v4/reference/sprite/#hoverOptions_property) which can be used to set up how touch "hovering" works.
3545
3546## [4.0.0-beta.28] - 2018-06-05
3547
3548### Fixed
3549- Using chart `Cursor` now prevents default browser gestures on touch and hybrid displays.
3550- Disabling elements (e.g. Legend or Axis labels) will now make other elements take up vacant space automatically.
3551- Tooltips on `XYSeries` data items with zero value were not being shown.
3552- Sometimes `XYSeries` tooltips were messed up and shown in incorrect position.
3553- Updating chart data with stacked series could result incorrect min/max values on `ValueAxis`.
3554- `Treemap` was not showing all the required levels on zoom-out unless animated theme was being used.
3555- Sometimes unpredictable behavior of labels on a logarithmic value axis was fixed.
3556- `DateAxis` with `skipEmptyPeriods = true` was showing axis tooltip at incorrect positions in some cases.
3557
3558### Changed
3559- `Sprite.mouseEnabled` was renamed to `interactionsEnabled`.
3560- An option `"mouse"` for `tooltipPosition` was renamed to `"pointer"`.
3561
3562## [4.0.0-beta.27] - 2018-06-01
3563
3564### Fixed
3565- Issue with `Label` text truncation.
3566- Huge performance improvements, especially on initial chart load.
3567- `Animation.resume()` was not working.
3568
3569### Changed
3570- Default `tooltipLocation` on `SankeyLink` is now `0.5`.
3571- Default value of `series.hiddenState.opacity` is now `0` (was `1`). Animated theme sets it to `1`, because it animates stuff by interpolation, rather than fade.
3572
3573### Added
3574- `pt_BR` and `en_CA` locales.
3575- `fullWords` property on `Label`. Works only when `truncate = true`. Setting to `false` will force non-fitting label to be truncated in the middle of the word.
3576
3577## [4.0.0-beta.26] - 2018-05-30
3578
3579### Fixed
3580- Error with `EventDispatcher is disposed`.
3581- Having "stray" axis objects (not attached to any chart) was resulting in critical error.
3582- Zooming was broken on `RadarCursor` since last update.
3583- `PieSeries.legendSettings` were being ingored.
3584- `Cursor` was incorrectly doing `panY` (inverted).
3585- Date axis tooltip was not rounding dates to `baseDuration`.
3586- Date axis was not working properly with `min`/`max` values set.
3587
3588### Changed
3589- Redone chart print functionality. Now printing is done via `<iframe>` by default. An alternative CSS option is also available.
3590- If series' bullets have hover state set, it will be applied whenever chart cursor is over position, even if not directly hovering over bullet.
3591- `XYSeries` used hidden/default state `transitionDuration` for interpolating values when showing/hiding series. Now they use `series.interpolationDuration`.
3592- ZoomOut button was under the cursor lines making it impossible to click.
3593- `easing` renamed to `transitionEasing` in SpriteState, for consistency.
3594- When setting `width`/`height` for an element in pixels, `minWidth` and `maxWidth` is also set to the same values.
3595- If `interpolationDuration` is 0 and `hiddenState.transitionDuration > 0`, the series will transit to hidden state first and then instantly interpolate values to 0.
3596
3597### Added
3598- Finished cursor updates to support cursor syncing.
3599
3600## [4.0.0-beta.25] - 2018-05-25
3601
3602### Fixed
3603- Using `tooltipHTML` was very buggy.
3604- Text formatting with two adjacent formatting blocks (`[...][...]`) was broken.
3605- `DateFormatter` was ignoring `utc` setting when formatting dates.
3606- Popup no longer obstructs the chart around it.
3607- Popup/Modal and Export Menu now temporarily disable all interactivity behind it.
3608
3609### Added
3610- `DataSource` now has property [`requestOptions`](https://www.amcharts.com/docs/v4/reference/datasource/#requestOptions_property) which you can use to add custom request headers to HTTP(S) requests.
3611- `Popup.title` property.
3612- `Popup.draggable` property (boolean). Default `true`. Makes popups draggable.
3613- `ru_RU` (Russian) and `nl_NL` (Dutch) translations.
3614- `Dictionary`, `DictionaryTemplate`, `List`, `ListTemplate`, `OrderedList`, `OrderedListTemplate`, `SortedList`, and `SortedListTemplate` have these new methods:
3615- `each` (which calls a function for each element in the data structure)
3616- `Symbol.iterator` (which is used for the ES6 iterator protocol)
3617- New `Cursor` event: `"behaviorcanceled"`. (called when zoom/pan/select operation is abandoned)
3618- New `Cursor` methods: [`triggerMove()`](https://www.amcharts.com/docs/v4/reference/cursor/#triggerMove_method), [`triggerDown()`](https://www.amcharts.com/docs/v4/reference/cursor/#triggerDown_method), and [`triggerUp()`](https://www.amcharts.com/docs/v4/reference/cursor/#triggerUp_method) for improving cursor syncing and manual placement.
3619- Support for `Series.heatRules` in JSON chart config.
3620- JSON config now supports arrays in `events` and `adapter`.
3621
3622### Changed
3623- HTML labels now take `fill` (color) parameter into account by translating it into `color` CSS property of the style.
3624- Now when data loader gracefully handles CORS and other critical load errors.
3625- `Chart.openPopup()` now does not ignore second parameter. (title)
3626- Changed default International English time with seconds format to `"HH:mm:ss"`.
3627- Date format on `DateAxis` tooltip will now use axis' `minPeriod` rather than current label period.
3628- `EventDispatacher.has()` function's second parameter (callback) is now optional. If it's not specified it will check whether **any** event handlers are present for this particular event type.
3629
3630## [4.0.0-beta.24] - 2018-05-16
3631### Fixed
3632- Mouse/touch-related functionality was preventing text selection on the whole document.
3633
3634### Added
3635- Added examples in JSON format. (available in JS-oriented packages and GitHub only)
3636- New events on `ExportMenu`: `"branchselected"`, `"branunselected"`, `"closed"`.
3637- Added [`Sprite.hoverOnFocus`](https://www.amcharts.com/docs/v4/reference/sprite/#hoverOnFocus_property) boolean setting. If set to `true` element will also trigger hover events on it when it gains focus, e.g. display tooltip. (accessibility feature)
3638
3639## [4.0.0-beta.23] - 2018-05-13
3640### Fixed
3641- Various internal things were not properly disposed.
3642
3643## [4.0.0-beta.22] - 2018-05-13
3644### Fixed
3645- Heights of vertical `HeatLegend`'s gradient band and value axis (labels) were different.
3646- `HeatLegend` without its `series` set was resulting in critical error.
3647- `HeatLegend` did not respect `dataField` setting in `Series.heatRules`.
3648
3649### Removed
3650- `newStack` from Series which was redundant.
3651
3652## [4.0.0-beta.21] - 2018-05-10
3653### Added
3654- New element class [`Popup`](https://www.amcharts.com/docs/v4/reference/popup/).
3655- New way to display pop-ups on charts via [`Sprite.popups`](https://www.amcharts.com/docs/v4/reference/sprite/#popups_property) and [`Sprite.openPopup`](https://www.amcharts.com/docs/v4/reference/sprite/#openPopup_method).
3656- New example "adding-live-data".
3657- Added this `CHANGELOG.md`.
3658
3659### Fixed
3660- Fixed automatically-calculated RadarChart radius on non-full-circle chart setups.
3661- Improved incremental data updates.
3662
3663## [4.0.0-beta.20] - 2018-05-09
3664- Internal maintenance release
3665
3666## [4.0.0-beta.19] - 2018-05-09
3667- Internal maintenance release
3668
3669## [4.0.0-beta.18] - 2018-05-09
3670- Internal maintenance release
3671
3672## [4.0.0-beta.17] - 2018-05-09
3673- Internal maintenance release
3674
3675## [4.0.0-beta.16] - 2018-05-09
3676- Internal maintenance release
3677
3678## [4.0.0-beta.15] - 2018-05-09
3679### Fixed
3680- `createFromConfig()` was not working properly if chart type was passed as a class reference.
3681- In JSON-based config, axes properties were not being set.
3682- In JSON-based config, referring to Series in `XYChartScrollbar` was giving an error.
3683- One-ended `SankeyLink` was not being drawn correctly.
3684
3685## [4.0.0-beta.14] - 2018-05-0
3686- Internal maintenance release
3687
3688## [4.0.0-beta.13] - 2018-05-04
3689- Internal maintenance release
3690
3691## [4.0.0-beta.12] - 2018-05-04
3692- Internal maintenance release
3693
3694## [4.0.0-beta.11] - 2018-05-03
3695### Added
3696- Added ability to automatically load geodata via `MapChart.geodataSource`. ([more info](https://www.amcharts.com/docs/v4/chart-types/map/#Loading_external_maps))
3697
3698### Changed
3699- `DateAxis.baseInterval` now defaults to 1.
3700
3701### Fixed
3702- Fixed bad tooltip behavior on the right-side axis.
3703- Fixed `DateAxis.skipEmptyTimeUnits` which was not working properly.