@amcharts/amcharts5-mcp 1.9.5 → 1.9.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/content/SKILL.md +143 -246
- package/content/flow.md +6 -6
- package/content/gantt.md +4 -4
- package/content/hierarchy.md +7 -7
- package/content/json.md +20 -20
- package/content/map.md +35 -37
- package/content/pie.md +8 -8
- package/content/radar.md +4 -4
- package/content/stock.md +14 -24
- package/content/timeline.md +2 -2
- package/content/ui-elements.md +4 -4
- package/content/venn.md +2 -2
- package/content/wordcloud.md +15 -15
- package/content/xy.md +32 -45
- package/extended/ai.md +9 -9
- package/extended/charts/flow-charts/arc-diagram.md +162 -128
- package/extended/charts/flow-charts/chord-diagram.md +256 -120
- package/extended/charts/flow-charts/flow-chart-bullets.md +64 -6
- package/extended/charts/flow-charts/sankey-diagram.md +273 -142
- package/extended/charts/flow-charts.md +134 -72
- package/extended/charts/gantt/cgantt-appearance.md +7 -5
- package/extended/charts/gantt/serializing-gantt-data.md +47 -5
- package/extended/charts/gantt.md +1 -167
- package/extended/charts/hierarchy/breadcrumbs.md +26 -2
- package/extended/charts/hierarchy/force-directed.md +216 -91
- package/extended/charts/hierarchy/hierarchy-api.md +65 -6
- package/extended/charts/hierarchy/hierarchy-drill-down.md +6 -1605
- package/extended/charts/hierarchy/hierarchy-link-bullets.md +64 -4
- package/extended/charts/hierarchy/hierarchy-node-colors.md +71 -49
- package/extended/charts/hierarchy/legend-hierarchy-series.md +40 -28
- package/extended/charts/hierarchy/pack.md +49 -9
- package/extended/charts/hierarchy/partition.md +78 -13
- package/extended/charts/hierarchy/sunburst.md +87 -20
- package/extended/charts/hierarchy/tree.md +178 -63
- package/extended/charts/hierarchy/treemap.md +2 -387
- package/extended/charts/hierarchy/voronoi-treemap.md +95 -37
- package/extended/charts/hierarchy.md +2 -696
- package/extended/charts/map-chart/clustered-point-series.md +76 -3
- package/extended/charts/map-chart/country-data.md +39 -19
- package/extended/charts/map-chart/graticule-series.md +24 -7
- package/extended/charts/map-chart/map-api.md +1 -74
- package/extended/charts/map-chart/map-drill-down.md +71 -28
- package/extended/charts/map-chart/map-line-series.md +190 -219
- package/extended/charts/map-chart/map-pan-zoom.md +250 -120
- package/extended/charts/map-chart/map-point-series.md +245 -200
- package/extended/charts/map-chart/map-polygon-series.md +3 -242
- package/extended/charts/map-chart/map-raster-series.md +89 -80
- package/extended/charts/map-chart/map-sankey-series.md +213 -284
- package/extended/charts/map-chart/map-translations.md +108 -499
- package/extended/charts/map-chart/night-series.md +92 -43
- package/extended/charts/map-chart/pixel-map-series.md +144 -84
- package/extended/charts/map-chart.md +3 -308
- package/extended/charts/percent-charts/grouping-slices.md +74 -65
- package/extended/charts/percent-charts/legend-percent-series.md +41 -29
- package/extended/charts/percent-charts/pie-chart/pie-series.md +4 -372
- package/extended/charts/percent-charts/pie-chart.md +127 -37
- package/extended/charts/percent-charts/sliced-chart/funnel-series.md +160 -35
- package/extended/charts/percent-charts/sliced-chart/pictorial-stacked-series.md +135 -21
- package/extended/charts/percent-charts/sliced-chart/pyramid-series.md +151 -39
- package/extended/charts/percent-charts/sliced-chart.md +108 -44
- package/extended/charts/percent-charts.md +7 -7
- package/extended/charts/radar-chart/gauge-charts.md +203 -39
- package/extended/charts/radar-chart/radar-axes.md +42 -7
- package/extended/charts/radar-chart/radar-series.md +12 -4
- package/extended/charts/radar-chart.md +179 -129
- package/extended/charts/stock/indicators.md +53 -190
- package/extended/charts/stock/panels.md +1 -254
- package/extended/charts/stock/percent-mode.md +45 -17
- package/extended/charts/stock/serializing-indicators-annotations.md +52 -10
- package/extended/charts/stock/stock-annotations.md +48 -21
- package/extended/charts/stock/stock-legend.md +43 -13
- package/extended/charts/stock/toolbar/comparison-control.md +91 -36
- package/extended/charts/stock/toolbar/data-save-control.md +63 -25
- package/extended/charts/stock/toolbar/date-range-selector.md +38 -13
- package/extended/charts/stock/toolbar/drawing-control.md +172 -68
- package/extended/charts/stock/toolbar/dropdown-control.md +32 -6
- package/extended/charts/stock/toolbar/dropdown-list-control.md +155 -71
- package/extended/charts/stock/toolbar/indicator-control.md +82 -25
- package/extended/charts/stock/toolbar/interval-control.md +58 -22
- package/extended/charts/stock/toolbar/period-selector.md +88 -31
- package/extended/charts/stock/toolbar/reset-control.md +26 -9
- package/extended/charts/stock/toolbar/series-type-control.md +44 -18
- package/extended/charts/stock/toolbar/settings-control.md +82 -32
- package/extended/charts/stock/toolbar.md +87 -124
- package/extended/charts/stock/translating-stock-chart.md +22 -4
- package/extended/charts/stock.md +196 -70
- package/extended/charts/timeline.md +199 -385
- package/extended/charts/venn.md +210 -79
- package/extended/charts/word-cloud.md +207 -134
- package/extended/charts/xy-chart/axes/axis-headers.md +27 -2
- package/extended/charts/xy-chart/axes/axis-ranges.md +193 -60
- package/extended/charts/xy-chart/axes/category-axis.md +54 -14
- package/extended/charts/xy-chart/axes/category-date-axis.md +59 -10
- package/extended/charts/xy-chart/axes/date-axis.md +275 -67
- package/extended/charts/xy-chart/axes/duration-axis.md +18 -2
- package/extended/charts/xy-chart/axes/gapless-date-axis.md +17 -6
- package/extended/charts/xy-chart/axes/value-axis.md +191 -41
- package/extended/charts/xy-chart/axes.md +43 -1716
- package/extended/charts/xy-chart/cursor.md +218 -80
- package/extended/charts/xy-chart/legend-xy-series.md +2 -299
- package/extended/charts/xy-chart/scrollbars.md +3 -517
- package/extended/charts/xy-chart/series/candlestick-series.md +77 -33
- package/extended/charts/xy-chart/series/column-series.md +132 -33
- package/extended/charts/xy-chart/series/line-series.md +104 -22
- package/extended/charts/xy-chart/series/smoothed-series.md +40 -24
- package/extended/charts/xy-chart/series/step-line-series.md +45 -9
- package/extended/charts/xy-chart/series.md +221 -84
- package/extended/charts/xy-chart/xy-chart-containers.md +39 -50
- package/extended/charts/xy-chart/zoom-and-pan.md +4 -2419
- package/extended/charts/xy-chart.md +145 -122
- package/extended/concepts/accessibility.md +198 -49
- package/extended/concepts/animations.md +8 -909
- package/extended/concepts/colors-gradients-and-patterns/filters.md +27 -52
- package/extended/concepts/colors-gradients-and-patterns/gradients.md +152 -71
- package/extended/concepts/colors-gradients-and-patterns/patterns.md +244 -221
- package/extended/concepts/colors-gradients-and-patterns/shadows.md +55 -31
- package/extended/concepts/colors-gradients-and-patterns.md +143 -183
- package/extended/concepts/common-elements/bullets.md +10 -1859
- package/extended/concepts/common-elements/buttons.md +106 -60
- package/extended/concepts/common-elements/containers.md +5 -1040
- package/extended/concepts/common-elements/graphics.md +66 -30
- package/extended/concepts/common-elements/html-content.md +65 -11
- package/extended/concepts/common-elements/images.md +35 -7
- package/extended/concepts/common-elements/labels.md +118 -50
- package/extended/concepts/common-elements/layers.md +31 -39
- package/extended/concepts/common-elements/modal-popups.md +72 -36
- package/extended/concepts/common-elements/tooltips.md +204 -45
- package/extended/concepts/common-elements.md +1 -1
- package/extended/concepts/data/net-load-utility.md +35 -46
- package/extended/concepts/data.md +299 -306
- package/extended/concepts/events.md +102 -26
- package/extended/concepts/exporting/annotator.md +71 -34
- package/extended/concepts/exporting/export-menu.md +144 -98
- package/extended/concepts/exporting/exporting-api.md +76 -8
- package/extended/concepts/exporting/exporting-data.md +116 -48
- package/extended/concepts/exporting/exporting-images.md +100 -55
- package/extended/concepts/exporting/exporting-pdf.md +171 -138
- package/extended/concepts/exporting/exporting-svg.md +72 -53
- package/extended/concepts/exporting/printing.md +61 -19
- package/extended/concepts/exporting.md +93 -119
- package/extended/concepts/formatters/data-placeholders.md +67 -43
- package/extended/concepts/formatters/formatting-dates.md +108 -388
- package/extended/concepts/formatters/formatting-durations.md +64 -55
- package/extended/concepts/formatters/text-styling.md +41 -74
- package/extended/concepts/formatters.md +44 -12
- package/extended/concepts/legend/heat-legend.md +2 -1233
- package/extended/concepts/legend.md +12 -1889
- package/extended/concepts/locales/creating-translations.md +201 -67
- package/extended/concepts/locales/right-to-left-support.md +2 -138
- package/extended/concepts/locales.md +29 -5
- package/extended/concepts/responsive.md +1 -103
- package/extended/concepts/serializing/chart-serializer.md +133 -148
- package/extended/concepts/serializing/json-editor.md +11 -6
- package/extended/concepts/serializing.md +257 -140
- package/extended/concepts/settings/adapters.md +55 -5
- package/extended/concepts/settings/heat-rules.md +142 -77
- package/extended/concepts/settings/list-templates.md +66 -8
- package/extended/concepts/settings/states.md +38 -29
- package/extended/concepts/settings/template-fields.md +26 -28
- package/extended/concepts/settings.md +47 -5
- package/extended/concepts/themes/creating-themes.md +297 -738
- package/extended/concepts.md +1 -1
- package/extended/examples/candlestick-ohlc/box-plot-chart.md +6 -4
- package/extended/examples/candlestick-ohlc/candlestick-chart.md +6 -4
- package/extended/examples/candlestick-ohlc/ohlc-chart.md +6 -4
- package/extended/examples/candlestick-ohlc/on-demand-data-loading.md +6 -4
- package/extended/examples/candlestick-ohlc/professional-candlesticks.md +6 -4
- package/extended/examples/candlestick-ohlc/stock-chart-candlesticks.md +6 -4
- package/extended/examples/column-bar/100-stacked-column-chart.md +6 -4
- package/extended/examples/column-bar/bar-and-line-chart-mix.md +6 -4
- package/extended/examples/column-bar/bar-chart-race.md +6 -4
- package/extended/examples/column-bar/bars-with-moving-bullets.md +6 -4
- package/extended/examples/column-bar/bullet-chart.md +6 -4
- package/extended/examples/column-bar/carbon-zero-progress.md +6 -4
- package/extended/examples/column-bar/clustered-bar-chart.md +6 -4
- package/extended/examples/column-bar/clustered-column-chart.md +6 -4
- package/extended/examples/column-bar/column-and-line-mix.md +6 -4
- package/extended/examples/column-bar/column-chart-images-top.md +6 -4
- package/extended/examples/column-bar/column-chart-with-patterns.md +5 -3
- package/extended/examples/column-bar/column-with-rotated-series.md +6 -4
- package/extended/examples/column-bar/columns-with-grainy-gradients.md +6 -4
- package/extended/examples/column-bar/columns-with-moving-bullets.md +6 -4
- package/extended/examples/column-bar/curved-columns.md +6 -4
- package/extended/examples/column-bar/divergent-stacked-bars.md +6 -4
- package/extended/examples/column-bar/drag-and-change-column-value.md +6 -4
- package/extended/examples/column-bar/drag-ordering-of-bars.md +6 -4
- package/extended/examples/column-bar/dumbbell-plot.md +6 -4
- package/extended/examples/column-bar/flame-chart.md +10 -6
- package/extended/examples/column-bar/floating-bar-chart.md +14 -29
- package/extended/examples/column-bar/grouped-and-sorted-columns.md +6 -4
- package/extended/examples/column-bar/grouped-stacks.md +6 -4
- package/extended/examples/column-bar/heat-map-with-legend.md +6 -4
- package/extended/examples/column-bar/horizontal-dumbbell-plot.md +6 -4
- package/extended/examples/column-bar/images-as-categories.md +20 -31
- package/extended/examples/column-bar/layered-column-chart.md +10 -9
- package/extended/examples/column-bar/lollipop-chart.md +6 -4
- package/extended/examples/column-bar/network-waterfall-chart.md +7 -5
- package/extended/examples/column-bar/pareto-diagram.md +6 -4
- package/extended/examples/column-bar/partitioned-bar-chart.md +6 -4
- package/extended/examples/column-bar/pictorial-column-chart.md +6 -4
- package/extended/examples/column-bar/real-time-data-sorting.md +6 -4
- package/extended/examples/column-bar/risk-heatmap.md +6 -4
- package/extended/examples/column-bar/simple-column-chart.md +6 -4
- package/extended/examples/column-bar/sorted-bar-chart.md +6 -4
- package/extended/examples/column-bar/stacked-bar-chart-with-negative-values.md +6 -4
- package/extended/examples/column-bar/stacked-bar-chart.md +6 -4
- package/extended/examples/column-bar/stacked-clustered-column-chart.md +6 -4
- package/extended/examples/column-bar/stacked-column-chart.md +6 -4
- package/extended/examples/column-bar/stacked-waterfall-chart.md +6 -4
- package/extended/examples/column-bar/step-count-chart.md +6 -4
- package/extended/examples/column-bar/time-zones-and-daylight-saving.md +6 -4
- package/extended/examples/column-bar/variance-indicators.md +6 -4
- package/extended/examples/column-bar/waffle-chart.md +6 -4
- package/extended/examples/column-bar/waterfall-chart.md +6 -4
- package/extended/examples/dashboards/maps-and-charts-dashboard.md +43 -21
- package/extended/examples/dashboards/road-trip-dashboard-with-map.md +6 -4
- package/extended/examples/docs-demos/a-wordcloud-with-a-custom-shape.md +185 -0
- package/extended/examples/docs-demos/adding-bullets-at-specific-dates.md +257 -0
- package/extended/examples/docs-demos/adding-events-to-bullets.md +166 -0
- package/extended/examples/docs-demos/adding-horizontal-line-drawing-dynamically-on-a-stock-chart.md +744 -0
- package/extended/examples/docs-demos/adding-images-to-container.md +83 -0
- package/extended/examples/docs-demos/adding-tooltips-to-pie-chart-slice-labels.md +96 -0
- package/extended/examples/docs-demos/alignment-of-nodes-on-sankey-diagram.md +79 -0
- package/extended/examples/docs-demos/amchrts-5-translating-country-names.md +79 -0
- package/extended/examples/docs-demos/annotating-charts.md +202 -0
- package/extended/examples/docs-demos/axis-bullets-on-opposite-side.md +277 -0
- package/extended/examples/docs-demos/axis-icons-via-ranges-2.md +236 -0
- package/extended/examples/docs-demos/axis-icons-via-ranges.md +229 -0
- package/extended/examples/docs-demos/axis-ranges-with-line-series-2.md +223 -0
- package/extended/examples/docs-demos/axis-ranges-with-line-series.md +223 -0
- package/extended/examples/docs-demos/axis-ranges-with-series.md +208 -0
- package/extended/examples/docs-demos/axis-ranges.md +242 -0
- package/extended/examples/docs-demos/axis-start-and-end-locations.md +161 -0
- package/extended/examples/docs-demos/basic-containers.md +79 -0
- package/extended/examples/docs-demos/basic-stock-chart.md +723 -0
- package/extended/examples/docs-demos/candlestick-series.md +200 -0
- package/extended/examples/docs-demos/canvas-and-svg-renderers.md +128 -0
- package/extended/examples/docs-demos/chart-title.md +192 -0
- package/extended/examples/docs-demos/chart-with-an-html-title.md +138 -0
- package/extended/examples/docs-demos/chart-with-annotator-support.md +201 -0
- package/extended/examples/docs-demos/chart-with-oversized-labels.md +118 -0
- package/extended/examples/docs-demos/chart-with-svg-filters.md +103 -0
- package/extended/examples/docs-demos/chart-with-title-and-sub-title.md +151 -0
- package/extended/examples/docs-demos/chord-diagram-2.md +84 -0
- package/extended/examples/docs-demos/chord-diagram.md +78 -0
- package/extended/examples/docs-demos/chord-directed-diagram.md +87 -0
- package/extended/examples/docs-demos/chord-non-ribbon-diagram.md +79 -0
- package/extended/examples/docs-demos/circular-labels.md +102 -0
- package/extended/examples/docs-demos/click-events-on-map-point-series.md +112 -0
- package/extended/examples/docs-demos/clustered-column-chart.md +127 -0
- package/extended/examples/docs-demos/clustering-columnseries.md +135 -0
- package/extended/examples/docs-demos/color-set-via-theme.md +188 -0
- package/extended/examples/docs-demos/column-chart-with-adapters-for-the-tooltips.md +161 -0
- package/extended/examples/docs-demos/column-series-with-adapters.md +125 -0
- package/extended/examples/docs-demos/column-series-with-bullet-masking-disabled.md +170 -0
- package/extended/examples/docs-demos/column-series-with-focusable-columns-2.md +139 -0
- package/extended/examples/docs-demos/column-series-with-focusable-columns.md +145 -0
- package/extended/examples/docs-demos/column-series-with-label-bullets.md +160 -0
- package/extended/examples/docs-demos/column-series-with-multiple-bullets.md +174 -0
- package/extended/examples/docs-demos/column-series-with-shadows.md +127 -0
- package/extended/examples/docs-demos/columns-with-custom-states.md +126 -0
- package/extended/examples/docs-demos/configuring-lineseries-appearance.md +129 -0
- package/extended/examples/docs-demos/consolidated-tooltip.md +232 -0
- package/extended/examples/docs-demos/creating-bullets-via-theme.md +174 -0
- package/extended/examples/docs-demos/cursor-and-legend-labels-with-category-axis.md +142 -0
- package/extended/examples/docs-demos/cursor-and-legend-labels.md +169 -0
- package/extended/examples/docs-demos/custom-button-to-add-data-items-2.md +212 -0
- package/extended/examples/docs-demos/custom-button-to-add-data-items-3.md +210 -0
- package/extended/examples/docs-demos/custom-button-to-add-data-items-4.md +210 -0
- package/extended/examples/docs-demos/custom-button-to-add-data-items-5.md +216 -0
- package/extended/examples/docs-demos/custom-button-to-add-data-items.md +197 -0
- package/extended/examples/docs-demos/custom-data-grouping-function.md +163 -0
- package/extended/examples/docs-demos/custom-pdf-export.md +269 -0
- package/extended/examples/docs-demos/custom-responsive-functions.md +110 -0
- package/extended/examples/docs-demos/custom-sankey-node-colors.md +103 -0
- package/extended/examples/docs-demos/custom-tooltip-on-scrollbar-grips.md +199 -0
- package/extended/examples/docs-demos/custom-xlsx-export.md +244 -0
- package/extended/examples/docs-demos/customizing-colors-of-a-stocktoolbar.md +708 -0
- package/extended/examples/docs-demos/customizing-tooltip-colors.md +177 -0
- package/extended/examples/docs-demos/data-grouping.md +152 -0
- package/extended/examples/docs-demos/date-axis-zoom-events.md +153 -0
- package/extended/examples/docs-demos/day-and-night-on-a-map.md +84 -0
- package/extended/examples/docs-demos/day-and-night-satellite-map.md +89 -0
- package/extended/examples/docs-demos/disabling-hovers-in-piechart-legend.md +99 -0
- package/extended/examples/docs-demos/disabling-radar-line-series-end-connection.md +199 -0
- package/extended/examples/docs-demos/display-charts-data-in-an-html-table.md +233 -0
- package/extended/examples/docs-demos/disposing-previously-created-root-element.md +188 -0
- package/extended/examples/docs-demos/dotted-world-map-with-heat-rules.md +118 -0
- package/extended/examples/docs-demos/drill-down-map.md +133 -0
- package/extended/examples/docs-demos/drill-down-sunburst-chart-via-api.md +168 -0
- package/extended/examples/docs-demos/drill-down-to-countries-with-zoom-control.md +227 -0
- package/extended/examples/docs-demos/drill-down-to-countries.md +200 -0
- package/extended/examples/docs-demos/duration-axis.md +140 -0
- package/extended/examples/docs-demos/dynamic-drill-down-map.md +171 -0
- package/extended/examples/docs-demos/dynamically-adding-and-removing-nodes-in-a-force-directed-tr.md +120 -0
- package/extended/examples/docs-demos/dynamically-changing-node-values-on-a-force-directed-tree.md +111 -0
- package/extended/examples/docs-demos/easing-functions-2.md +113 -0
- package/extended/examples/docs-demos/easing-functions.md +106 -0
- package/extended/examples/docs-demos/easing.md +97 -0
- package/extended/examples/docs-demos/expanded-tooltip-area.md +110 -0
- package/extended/examples/docs-demos/exporting-as-svg.md +107 -0
- package/extended/examples/docs-demos/exporting-data-with-custom-menu-2.md +262 -0
- package/extended/examples/docs-demos/exporting-data-with-custom-menu.md +252 -0
- package/extended/examples/docs-demos/exporting-data.md +246 -0
- package/extended/examples/docs-demos/exporting-menu-in-external-container.md +251 -0
- package/extended/examples/docs-demos/fill-on-a-plot-container.md +189 -0
- package/extended/examples/docs-demos/fixing-y-axis-zoom.md +145 -0
- package/extended/examples/docs-demos/flight-routes-arcing-above-a-globe.md +157 -0
- package/extended/examples/docs-demos/force-directed-chart-2.md +337 -0
- package/extended/examples/docs-demos/force-directed-chart-with-a-legend.md +365 -0
- package/extended/examples/docs-demos/force-directed-chart-with-cross-linked-nodes.md +139 -0
- package/extended/examples/docs-demos/force-directed-chart-with-fixed-nodes.md +346 -0
- package/extended/examples/docs-demos/force-directed-chart-with-images-as-nodes-2.md +148 -0
- package/extended/examples/docs-demos/force-directed-chart-with-images-as-nodes.md +124 -0
- package/extended/examples/docs-demos/force-directed-chart-with-legend.md +349 -0
- package/extended/examples/docs-demos/force-directed-chart-with-strength-configuration.md +140 -0
- package/extended/examples/docs-demos/force-directed-chart-with-topdepth-2.md +110 -0
- package/extended/examples/docs-demos/force-directed-chart-with-topdepth.md +340 -0
- package/extended/examples/docs-demos/force-directed-chart.md +350 -0
- package/extended/examples/docs-demos/force-directed-tree-with-animated-bullets.md +163 -0
- package/extended/examples/docs-demos/force-directed-tree-with-bullets.md +148 -0
- package/extended/examples/docs-demos/formatting-date-axis-labels.md +197 -0
- package/extended/examples/docs-demos/funnel-chart-2.md +105 -0
- package/extended/examples/docs-demos/funnel-chart.md +90 -0
- package/extended/examples/docs-demos/funnel-with-bullets.md +116 -0
- package/extended/examples/docs-demos/gantt-chart-w-data-saving-to-localstorage.md +309 -0
- package/extended/examples/docs-demos/gantt-chart-with-external-data.md +163 -0
- package/extended/examples/docs-demos/gantt-chart.md +173 -0
- package/extended/examples/docs-demos/gapless-date-axis.md +157 -0
- package/extended/examples/docs-demos/gauge-chart-2.md +117 -0
- package/extended/examples/docs-demos/gauge-chart-with-hand.md +145 -0
- package/extended/examples/docs-demos/gauge-chart.md +69 -0
- package/extended/examples/docs-demos/globe-with-a-raised-sun.md +104 -0
- package/extended/examples/docs-demos/globe-with-value-columns.md +120 -0
- package/extended/examples/docs-demos/gradients-2.md +127 -0
- package/extended/examples/docs-demos/gradients-with-line-series.md +140 -0
- package/extended/examples/docs-demos/gradients.md +167 -0
- package/extended/examples/docs-demos/grid-layout-of-the-container.md +90 -0
- package/extended/examples/docs-demos/heat-rules-on-columnseries-2.md +141 -0
- package/extended/examples/docs-demos/heat-rules-on-columnseries.md +133 -0
- package/extended/examples/docs-demos/horizontal-arc-diagram.md +151 -0
- package/extended/examples/docs-demos/horizontal-partition-chart.md +335 -0
- package/extended/examples/docs-demos/horizontal-pictorial-stacked-series.md +96 -0
- package/extended/examples/docs-demos/horizontal-tree-chart.md +150 -0
- package/extended/examples/docs-demos/html-labels-on-a-dateaxis.md +175 -0
- package/extended/examples/docs-demos/html-tooltips-2.md +138 -0
- package/extended/examples/docs-demos/html-tooltips.md +139 -0
- package/extended/examples/docs-demos/image-patterns.md +144 -0
- package/extended/examples/docs-demos/images-as-legend-markers-2.md +210 -0
- package/extended/examples/docs-demos/images-as-legend-markers.md +215 -0
- package/extended/examples/docs-demos/including-legend-from-external-container-into-export.md +175 -0
- package/extended/examples/docs-demos/json-config-with-an-opening-animation.md +128 -0
- package/extended/examples/docs-demos/keyboard-controllable-xy-cursor.md +173 -0
- package/extended/examples/docs-demos/legend-with-column-series-data-items.md +134 -0
- package/extended/examples/docs-demos/legend-with-custom-data.md +149 -0
- package/extended/examples/docs-demos/line-series-with-bullets-2.md +166 -0
- package/extended/examples/docs-demos/line-series-with-bullets.md +161 -0
- package/extended/examples/docs-demos/line-series-with-focusable-bullets.md +164 -0
- package/extended/examples/docs-demos/lineseries-strokefill-settings-via-json-config.md +232 -0
- package/extended/examples/docs-demos/lineseries-with-breaks.md +127 -0
- package/extended/examples/docs-demos/lineseries-with-open-data-fields.md +132 -0
- package/extended/examples/docs-demos/map-chart-heat-map-with-heat-legend.md +170 -0
- package/extended/examples/docs-demos/map-chart-heat-map.md +138 -0
- package/extended/examples/docs-demos/map-chart-with-orthographic-projection-globe.md +86 -0
- package/extended/examples/docs-demos/map-chart.md +77 -0
- package/extended/examples/docs-demos/map-line-and-point-series-used-together-2.md +115 -0
- package/extended/examples/docs-demos/map-line-and-point-series-used-together.md +105 -0
- package/extended/examples/docs-demos/map-line-pushing-data-items.md +90 -0
- package/extended/examples/docs-demos/map-point-series-creating-individual-data-items-2.md +103 -0
- package/extended/examples/docs-demos/map-point-series-creating-individual-data-items-3.md +88 -0
- package/extended/examples/docs-demos/map-point-series-creating-individual-data-items.md +86 -0
- package/extended/examples/docs-demos/map-point-series-with-data-and-datafields.md +102 -0
- package/extended/examples/docs-demos/map-point-series-with-data.md +105 -0
- package/extended/examples/docs-demos/map-point-series-with-geojson.md +128 -0
- package/extended/examples/docs-demos/map-sankey-chart-global-coffee-supply-chain.md +417 -0
- package/extended/examples/docs-demos/map-with-clustered-points.md +335 -0
- package/extended/examples/docs-demos/map-with-graticule-series.md +93 -0
- package/extended/examples/docs-demos/map-with-line-series-via-data.md +92 -0
- package/extended/examples/docs-demos/map-with-line-series.md +103 -0
- package/extended/examples/docs-demos/marker-moving-along-a-route.md +139 -0
- package/extended/examples/docs-demos/modal-popups-in-amcharts-5.md +214 -0
- package/extended/examples/docs-demos/modifying-active-state-on-pie-slices.md +90 -0
- package/extended/examples/docs-demos/modifying-chart-for-export.md +188 -0
- package/extended/examples/docs-demos/modifying-state-animation-options.md +131 -0
- package/extended/examples/docs-demos/multi-panel-stock-chart.md +261 -0
- package/extended/examples/docs-demos/multi-part-gauge.md +183 -0
- package/extended/examples/docs-demos/multiple-pie-series.md +125 -0
- package/extended/examples/docs-demos/multiple-root-elements.md +124 -0
- package/extended/examples/docs-demos/open-an-url-on-force-directed-node-click.md +653 -0
- package/extended/examples/docs-demos/opening-animation-with-autoappear.md +109 -0
- package/extended/examples/docs-demos/pack-chart.md +342 -0
- package/extended/examples/docs-demos/partition-chart.md +255 -0
- package/extended/examples/docs-demos/patterns.md +143 -0
- package/extended/examples/docs-demos/pdf-export-with-korean-characters-in-data.md +119 -0
- package/extended/examples/docs-demos/pictorial-stacked-series.md +95 -0
- package/extended/examples/docs-demos/pie-chart-legend-alignment-2.md +116 -0
- package/extended/examples/docs-demos/pie-chart-legend-alignment.md +112 -0
- package/extended/examples/docs-demos/pie-chart-with-a-custom-mask.md +96 -0
- package/extended/examples/docs-demos/pie-chart-with-custom-legend.md +127 -0
- package/extended/examples/docs-demos/pie-chart-with-external-horizontally-scrollable-legend.md +182 -0
- package/extended/examples/docs-demos/pie-chart-with-external-legend-2.md +173 -0
- package/extended/examples/docs-demos/pie-chart-with-external-legend.md +161 -0
- package/extended/examples/docs-demos/pie-chart-with-gradient-fill-and-grain-pattern.md +96 -0
- package/extended/examples/docs-demos/pie-chart-with-inner-radius-donut.md +89 -0
- package/extended/examples/docs-demos/pie-chart-with-radial-gradient.md +113 -0
- package/extended/examples/docs-demos/pie-chart-with-scrollable-legend.md +141 -0
- package/extended/examples/docs-demos/pie-chart.md +95 -0
- package/extended/examples/docs-demos/piechart-from-json-config.md +144 -0
- package/extended/examples/docs-demos/pieseries-slice-colors-via-data.md +113 -0
- package/extended/examples/docs-demos/pixel-shapes.md +107 -0
- package/extended/examples/docs-demos/positioning-series-bullets-by-data-field.md +184 -0
- package/extended/examples/docs-demos/pre-hidden-nodes-in-sankey.md +95 -0
- package/extended/examples/docs-demos/pre-hiding-series.md +181 -0
- package/extended/examples/docs-demos/pre-zoom-the-map-to-a-list-of-countries.md +86 -0
- package/extended/examples/docs-demos/pre-zooming-date-axis.md +159 -0
- package/extended/examples/docs-demos/profesional-candlesticks.md +206 -0
- package/extended/examples/docs-demos/radar-chart-axis-labels-2.md +205 -0
- package/extended/examples/docs-demos/radar-chart-axis-labels.md +210 -0
- package/extended/examples/docs-demos/radar-chart-with-custom-angles.md +210 -0
- package/extended/examples/docs-demos/radar-chart-with-date-axis.md +222 -0
- package/extended/examples/docs-demos/radar-chart-with-heat-legend.md +1077 -0
- package/extended/examples/docs-demos/radial-labels.md +102 -0
- package/extended/examples/docs-demos/removing-axes.md +196 -0
- package/extended/examples/docs-demos/removing-nodes-from-a-force-directed-tree-2.md +671 -0
- package/extended/examples/docs-demos/removing-nodes-from-a-force-directed-tree.md +654 -0
- package/extended/examples/docs-demos/resizing-exported-chart.md +191 -0
- package/extended/examples/docs-demos/retrieving-latlong-coordinates-of-a-map-click.md +81 -0
- package/extended/examples/docs-demos/right-to-left-chart.md +98 -0
- package/extended/examples/docs-demos/rotated-axis-labels.md +157 -0
- package/extended/examples/docs-demos/round-voronoi-treemap.md +1554 -0
- package/extended/examples/docs-demos/sankey-diagram-2.md +95 -0
- package/extended/examples/docs-demos/sankey-diagram-with-animated-bullets.md +118 -0
- package/extended/examples/docs-demos/sankey-diagram-with-bullets-2.md +108 -0
- package/extended/examples/docs-demos/sankey-diagram-with-bullets.md +103 -0
- package/extended/examples/docs-demos/sankey-diagram-with-labels-inside-node.md +97 -0
- package/extended/examples/docs-demos/sankey-diagram.md +78 -0
- package/extended/examples/docs-demos/satellite-globe.md +108 -0
- package/extended/examples/docs-demos/satellites-at-different-heights.md +138 -0
- package/extended/examples/docs-demos/scrollbar-with-chart-preview-2.md +171 -0
- package/extended/examples/docs-demos/scrollbar-with-chart-preview.md +188 -0
- package/extended/examples/docs-demos/selectively-displaying-bullets.md +183 -0
- package/extended/examples/docs-demos/series-tooltips-and-cursor.md +151 -0
- package/extended/examples/docs-demos/setting-xycursor-position.md +214 -0
- package/extended/examples/docs-demos/sizing-gradient-based-on-charts-plot-area.md +133 -0
- package/extended/examples/docs-demos/sizing-scrollbar-elements.md +176 -0
- package/extended/examples/docs-demos/slice-grouper-with-breakdown-of-the-other-slice-in-a-tooltip.md +154 -0
- package/extended/examples/docs-demos/slice-grouper-with-pie-series.md +133 -0
- package/extended/examples/docs-demos/sliced-chart-with-multiple-series.md +102 -0
- package/extended/examples/docs-demos/smoothed-line-series-2.md +183 -0
- package/extended/examples/docs-demos/smoothed-line-series.md +152 -0
- package/extended/examples/docs-demos/spectrum-chart.md +269 -0
- package/extended/examples/docs-demos/stacked-axes-legend.md +168 -0
- package/extended/examples/docs-demos/stacked-axes.md +159 -0
- package/extended/examples/docs-demos/stacked-bullets.md +278 -0
- package/extended/examples/docs-demos/stacked-column-chart-100.md +124 -0
- package/extended/examples/docs-demos/stacked-column-chart.md +114 -0
- package/extended/examples/docs-demos/start-and-end-angles-of-a-pie-chart.md +91 -0
- package/extended/examples/docs-demos/state-abbreviations-on-a-us-map.md +109 -0
- package/extended/examples/docs-demos/step-line-chart.md +198 -0
- package/extended/examples/docs-demos/steplineseries-with-no-risers-2.md +129 -0
- package/extended/examples/docs-demos/steplineseries-with-no-risers.md +127 -0
- package/extended/examples/docs-demos/sticky-tooltips-on-bullets.md +159 -0
- package/extended/examples/docs-demos/sticky-tooltips-on-columns.md +133 -0
- package/extended/examples/docs-demos/stock-chart-2.md +678 -0
- package/extended/examples/docs-demos/stock-chart-controls-series-type-control.md +345 -0
- package/extended/examples/docs-demos/stock-chart-controls.md +250 -0
- package/extended/examples/docs-demos/stock-chart-with-comparison-and-dynamic-search.md +395 -0
- package/extended/examples/docs-demos/stock-chart-with-comparison.md +366 -0
- package/extended/examples/docs-demos/stock-chart-with-custom-dropdown-control-2.md +317 -0
- package/extended/examples/docs-demos/stock-chart-with-custom-dropdown-control.md +254 -0
- package/extended/examples/docs-demos/stock-chart-with-custom-settings-control.md +287 -0
- package/extended/examples/docs-demos/stock-chart-with-custom-translation.md +677 -0
- package/extended/examples/docs-demos/stock-chart-with-data-granularity-switcher.md +407 -0
- package/extended/examples/docs-demos/stock-chart-with-dateperiod-selector.md +254 -0
- package/extended/examples/docs-demos/stock-chart-with-disabled-settings-icon-for-single-series.md +566 -0
- package/extended/examples/docs-demos/stock-chart-with-indicator-control.md +250 -0
- package/extended/examples/docs-demos/stock-chart-with-serialized-drawings-and-indicators.md +2283 -0
- package/extended/examples/docs-demos/stock-chart-with-series-type-control.md +323 -0
- package/extended/examples/docs-demos/stock-chart-with-settings-and-close-buttons-disabled-in-the.md +568 -0
- package/extended/examples/docs-demos/stock-chart.md +726 -0
- package/extended/examples/docs-demos/strip-count-plot.md +266 -0
- package/extended/examples/docs-demos/styling-columnseries.md +124 -0
- package/extended/examples/docs-demos/sunburst-chart-2.md +342 -0
- package/extended/examples/docs-demos/sunburst-chart-with-custom-startend-angles.md +345 -0
- package/extended/examples/docs-demos/sunburst-chart-with-inner-radius.md +343 -0
- package/extended/examples/docs-demos/sunburst-chart.md +336 -0
- package/extended/examples/docs-demos/surface-bullets-on-a-globe.md +122 -0
- package/extended/examples/docs-demos/svg-path-converter-to-points.md +166 -0
- package/extended/examples/docs-demos/svg-path-patterns.md +155 -0
- package/extended/examples/docs-demos/synced-value-axes.md +151 -0
- package/extended/examples/docs-demos/syncing-axis-widths-across-multiple-charts.md +188 -0
- package/extended/examples/docs-demos/syncing-cursors-across-several-charts.md +182 -0
- package/extended/examples/docs-demos/timeline-chart-serpentine.md +387 -0
- package/extended/examples/docs-demos/timeline-chart-spiral.md +385 -0
- package/extended/examples/docs-demos/timeline-chart.md +222 -0
- package/extended/examples/docs-demos/tooltip-orientation.md +144 -0
- package/extended/examples/docs-demos/tooltip-position.md +135 -0
- package/extended/examples/docs-demos/tooltip-shadows.md +249 -0
- package/extended/examples/docs-demos/tooltips-on-axis-labels.md +200 -0
- package/extended/examples/docs-demos/tracking-xycursor-position.md +161 -0
- package/extended/examples/docs-demos/tree-chart-configuring-node-outer-circles.md +161 -0
- package/extended/examples/docs-demos/tree-chart-configuring-node-radii-2.md +166 -0
- package/extended/examples/docs-demos/tree-chart-configuring-node-radii-3.md +151 -0
- package/extended/examples/docs-demos/tree-chart-configuring-node-radii.md +157 -0
- package/extended/examples/docs-demos/tree-chart-with-cross-linked-nodes.md +136 -0
- package/extended/examples/docs-demos/tree-chart.md +144 -0
- package/extended/examples/docs-demos/treemap-chart-2.md +259 -0
- package/extended/examples/docs-demos/treemap-chart-with-heat-rules.md +151 -0
- package/extended/examples/docs-demos/treemap-chart.md +343 -0
- package/extended/examples/docs-demos/treemap-parent-headers.md +140 -0
- package/extended/examples/docs-demos/treemap-using-adapters-for-rectangle-fills.md +124 -0
- package/extended/examples/docs-demos/turning-off-label-alignment.md +100 -0
- package/extended/examples/docs-demos/updating-series-values.md +119 -0
- package/extended/examples/docs-demos/us-map-with-state-grouped-clustered-points.md +3252 -0
- package/extended/examples/docs-demos/using-d3-curve-factories.md +223 -0
- package/extended/examples/docs-demos/using-d3-map-projections.md +247 -0
- package/extended/examples/docs-demos/using-ellipses-as-nodes-in-force-directed-tree.md +684 -0
- package/extended/examples/docs-demos/using-exporting-api-2.md +150 -0
- package/extended/examples/docs-demos/using-exporting-api.md +148 -0
- package/extended/examples/docs-demos/using-graphics-elements-2.md +73 -0
- package/extended/examples/docs-demos/using-graphics-elements-3.md +73 -0
- package/extended/examples/docs-demos/using-graphics-elements.md +69 -0
- package/extended/examples/docs-demos/using-interface-colors.md +195 -0
- package/extended/examples/docs-demos/using-templatedield-in-mappolygonseries.md +100 -0
- package/extended/examples/docs-demos/using-templatefield-in-sankey-diagram.md +118 -0
- package/extended/examples/docs-demos/using-templatefield-on-lineseries-troke.md +169 -0
- package/extended/examples/docs-demos/using-templatefield-with-bullets.md +186 -0
- package/extended/examples/docs-demos/using-templatefield-with-columnseries.md +147 -0
- package/extended/examples/docs-demos/value-dependent-coloring-of-columnseries.md +132 -0
- package/extended/examples/docs-demos/variable-radius-ranges-on-a-gauge.md +118 -0
- package/extended/examples/docs-demos/venn-diagram.md +105 -0
- package/extended/examples/docs-demos/vertical-arc-diagram.md +127 -0
- package/extended/examples/docs-demos/week-start-on-sunday.md +155 -0
- package/extended/examples/docs-demos/word-cloud-with-events.md +155 -0
- package/extended/examples/docs-demos/word-cloud.md +74 -0
- package/extended/examples/docs-demos/xy-scatter-chart-with-heat-rules-on-bullets.md +325 -0
- package/extended/examples/docs-demos/xychart-from-json-config-with-axis-bullets.md +228 -0
- package/extended/examples/docs-demos/xychart-from-json-config-with-axis-ranges.md +257 -0
- package/extended/examples/docs-demos/xychart-from-json-config.md +196 -0
- package/extended/examples/docs-demos/xychart-with-legend-via-json-config.md +260 -0
- package/extended/examples/docs-demos/zoom-to-a-clicked-country.md +97 -0
- package/extended/examples/docs-demos/zoomable-force-directed-tree.md +660 -0
- package/extended/examples/docs-demos/zoomable-value-axes.md +188 -0
- package/extended/examples/docs-demos/zooming-by-axis-pan.md +1880 -0
- package/extended/examples/docs-demos/zooming-map-with-ctrl-key-and-mouse-wheel-curtain.md +122 -0
- package/extended/examples/docs-demos/zooming-map-with-ctrl-key-and-mouse-wheel.md +88 -0
- package/extended/examples/docs-demos/zooming-with-ctrl-key-and-mouse-wheel-curtain.md +221 -0
- package/extended/examples/docs-demos/zooming-with-ctrl-key-and-mouse-wheel.md +183 -0
- package/extended/examples/flow/animated-sankey-diagram.md +32 -8
- package/extended/examples/flow/chord-diagram-with-animated-bullets.md +6 -4
- package/extended/examples/flow/chord-diagram.md +6 -4
- package/extended/examples/flow/horizontal-arc-diagram.md +6 -4
- package/extended/examples/flow/non-ribbon-chord-diagram.md +6 -4
- package/extended/examples/flow/sankey-diagram.md +6 -4
- package/extended/examples/flow/toggleable-chord-diagram.md +6 -4
- package/extended/examples/flow/traceable-sankey-diagram.md +7 -5
- package/extended/examples/flow/vertical-arc-diagram.md +7 -7
- package/extended/examples/flow/vertical-sankey-diagram.md +6 -4
- package/extended/examples/funnel-pyramid/funnel-chart-with-rounded-corners.md +6 -4
- package/extended/examples/funnel-pyramid/funnel-chart.md +6 -4
- package/extended/examples/funnel-pyramid/funnel-with-gradient-fill.md +6 -4
- package/extended/examples/funnel-pyramid/horizontal-funnel.md +6 -4
- package/extended/examples/funnel-pyramid/horizontal-pictorial-chart.md +11 -6
- package/extended/examples/funnel-pyramid/pictorial-chart.md +6 -4
- package/extended/examples/funnel-pyramid/pictorial-fraction-chart.md +6 -4
- package/extended/examples/funnel-pyramid/pictorial-stacked-chart.md +6 -4
- package/extended/examples/funnel-pyramid/pyramid-chart.md +6 -4
- package/extended/examples/gantt/editable-multilevel-gantt-chart.md +5 -3
- package/extended/examples/gantt/gantt-chart-dates.md +5 -3
- package/extended/examples/gantt/gantt-chart-in-read-only-mode.md +5 -3
- package/extended/examples/gantt/gantt-chart-playground.md +5 -3
- package/extended/examples/gantt/gantt-chart.md +5 -3
- package/extended/examples/gantt/gantt-with-hundreds-of-items.md +5 -3
- package/extended/examples/gauges/angular-gauge-with-two-axes.md +6 -4
- package/extended/examples/gauges/angular-gauge.md +6 -4
- package/extended/examples/gauges/animated-gauge.md +6 -4
- package/extended/examples/gauges/clock-with-two-faces.md +6 -4
- package/extended/examples/gauges/clock.md +6 -4
- package/extended/examples/gauges/compass-chart.md +6 -4
- package/extended/examples/gauges/gauge-with-bands.md +7 -4
- package/extended/examples/gauges/gauge-with-gradient-fill.md +6 -4
- package/extended/examples/gauges/multi-part-gauge.md +6 -4
- package/extended/examples/gauges/solid-gauge.md +6 -4
- package/extended/examples/gauges/yes-and-no-gauge.md +6 -4
- package/extended/examples/hierarchy/collapsible-force-directed-tree.md +6 -4
- package/extended/examples/hierarchy/drill-down-sunburst-chart.md +6 -4
- package/extended/examples/hierarchy/drill-down-treemap.md +6 -4
- package/extended/examples/hierarchy/dynamic-data-updates-on-treemap.md +6 -4
- package/extended/examples/hierarchy/force-directed-adding-links.md +6 -4
- package/extended/examples/hierarchy/force-directed-network.md +6 -4
- package/extended/examples/hierarchy/force-directed-tree-with-animated-bullets.md +6 -4
- package/extended/examples/hierarchy/force-directed-tree.md +6 -4
- package/extended/examples/hierarchy/horizontal-partition-chart.md +6 -4
- package/extended/examples/hierarchy/multilevel-tree-map.md +6 -4
- package/extended/examples/hierarchy/packed-circle-chart.md +6 -4
- package/extended/examples/hierarchy/rectangular-voronoi-tree-map.md +7 -5
- package/extended/examples/hierarchy/simple-treemap.md +6 -4
- package/extended/examples/hierarchy/single-level-packed-circles.md +6 -4
- package/extended/examples/hierarchy/sunburst-chart.md +6 -4
- package/extended/examples/hierarchy/sunburst-flavor-wheel.md +6 -4
- package/extended/examples/hierarchy/tree-chart.md +7 -5
- package/extended/examples/hierarchy/vertical-partition-chart.md +6 -4
- package/extended/examples/hierarchy/voronoi-treemap.md +7 -5
- package/extended/examples/hierarchy/zoomable-force-directed-tree.md +6 -4
- package/extended/examples/line-area/100-stacked-area-chart.md +6 -4
- package/extended/examples/line-area/animated-bullet-at-the-end-of-the-series.md +6 -4
- package/extended/examples/line-area/area-with-time-based-data.md +6 -4
- package/extended/examples/line-area/chart-with-gaps-in-data.md +6 -4
- package/extended/examples/line-area/comparing-different-date-values-google-analytics-style.md +6 -4
- package/extended/examples/line-area/control-chart.md +6 -4
- package/extended/examples/line-area/cpu-and-memory-timeline.md +11 -6
- package/extended/examples/line-area/data-grouping-50k-points.md +6 -4
- package/extended/examples/line-area/date-axis-with-labels-near-minor-grid-lines.md +6 -4
- package/extended/examples/line-area/date-based-data.md +6 -4
- package/extended/examples/line-area/date-based-line-chart.md +6 -4
- package/extended/examples/line-area/divergent-lines.md +7 -4
- package/extended/examples/line-area/draggable-range-with-close-button.md +6 -4
- package/extended/examples/line-area/drawing-chart-series-with-mouse-or-touch.md +6 -4
- package/extended/examples/line-area/duration-on-value-axis.md +6 -4
- package/extended/examples/line-area/error-chart.md +6 -4
- package/extended/examples/line-area/evenly-spaced-date-axis.md +6 -4
- package/extended/examples/line-area/highlighting-line-chart-series-on-legend-hover.md +11 -16
- package/extended/examples/line-area/line-chart-adding-data-every-second.md +6 -4
- package/extended/examples/line-area/line-chart-with-horizontal-target.md +6 -4
- package/extended/examples/line-area/line-chart-with-range-slider.md +9 -7
- package/extended/examples/line-area/line-chart-with-scroll-and-zoom.md +6 -4
- package/extended/examples/line-area/line-different-colors-ups-downs.md +6 -4
- package/extended/examples/line-area/line-graph.md +6 -4
- package/extended/examples/line-area/line-with-changing-color.md +6 -4
- package/extended/examples/line-area/line-with-custom-bullets.md +6 -4
- package/extended/examples/line-area/line-with-data-labels.md +6 -4
- package/extended/examples/line-area/live-data.md +6 -4
- package/extended/examples/line-area/live-order-book-depth-chart.md +6 -4
- package/extended/examples/line-area/logarithmic-scale.md +6 -4
- package/extended/examples/line-area/manipulate-chart-data-with-mouse.md +6 -4
- package/extended/examples/line-area/mixed-daily-and-intra-day-chart.md +6 -4
- package/extended/examples/line-area/multiple-date-axes.md +6 -4
- package/extended/examples/line-area/multiple-value-axes.md +6 -4
- package/extended/examples/line-area/no-gap-date-axis.md +6 -4
- package/extended/examples/line-area/process-control-chart.md +7 -5
- package/extended/examples/line-area/range-area-chart.md +6 -4
- package/extended/examples/line-area/range-chart-with-different-fill-colors.md +6 -4
- package/extended/examples/line-area/reversed-value-axis.md +6 -4
- package/extended/examples/line-area/selecting-and-marking-multiple-ranges.md +6 -4
- package/extended/examples/line-area/show-percentage-change.md +6 -4
- package/extended/examples/line-area/smoothed-line-chart.md +6 -4
- package/extended/examples/line-area/smoothed-stacked-area.md +6 -4
- package/extended/examples/line-area/spline-graph.md +6 -4
- package/extended/examples/line-area/stacked-area.md +6 -4
- package/extended/examples/line-area/step-line-chart.md +6 -4
- package/extended/examples/line-area/step-line-without-risers.md +6 -4
- package/extended/examples/line-area/stream-chart.md +6 -4
- package/extended/examples/line-area/trend-lines.md +6 -4
- package/extended/examples/line-area/vertical-line-chart.md +14 -13
- package/extended/examples/line-area/zoomable-value-axis.md +6 -4
- package/extended/examples/maps/animations-along-lines.md +6 -4
- package/extended/examples/maps/approximate-working-hours-map.md +6 -4
- package/extended/examples/maps/capitals-map.md +7 -5
- package/extended/examples/maps/changing-map-projection.md +6 -4
- package/extended/examples/maps/day-and-night-world-map.md +118 -24
- package/extended/examples/maps/drill-down-congressional-map.md +6 -4
- package/extended/examples/maps/drill-down-map.md +6 -4
- package/extended/examples/maps/drill-down-to-countries.md +6 -4
- package/extended/examples/maps/flight-routes-map.md +6 -4
- package/extended/examples/maps/globe-with-projected-circles.md +6 -4
- package/extended/examples/maps/globe-with-raised-arcs.md +6 -4
- package/extended/examples/maps/globe-with-raised-parallels.md +6 -4
- package/extended/examples/maps/globe-with-surface-bullets.md +6 -4
- package/extended/examples/maps/grouped-countries-map.md +6 -4
- package/extended/examples/maps/jupiter-and-its-moons.md +6 -4
- package/extended/examples/maps/location-sensitive-map.md +6 -4
- package/extended/examples/maps/london-traffic-map.md +235 -0
- package/extended/examples/maps/map-bubbles.md +6 -4
- package/extended/examples/maps/map-dynamic-pie-charts.md +6 -4
- package/extended/examples/maps/map-image-drill-down.md +6 -4
- package/extended/examples/maps/map-sankey-series.md +3 -2
- package/extended/examples/maps/map-timeline.md +6 -4
- package/extended/examples/maps/map-using-d3-projections.md +14 -5
- package/extended/examples/maps/map-with-animated-bubbles.md +6 -4
- package/extended/examples/maps/map-with-animated-lines.md +6 -4
- package/extended/examples/maps/map-with-curved-lines.md +6 -4
- package/extended/examples/maps/map-with-patterns.md +10 -6
- package/extended/examples/maps/map-with-pulsating-bullets.md +6 -4
- package/extended/examples/maps/map-with-sized-pin-bullets.md +6 -4
- package/extended/examples/maps/mars-landing-sites.md +6 -4
- package/extended/examples/maps/multi-series-map.md +6 -4
- package/extended/examples/maps/pacific-centered-map.md +6 -4
- package/extended/examples/maps/pixel-map.md +6 -4
- package/extended/examples/maps/rotate-globe-to-a-selected-country.md +208 -110
- package/extended/examples/maps/rotating-globe-with-circles.md +6 -4
- package/extended/examples/maps/rotating-globe.md +115 -25
- package/extended/examples/maps/rotating-moon.md +6 -4
- package/extended/examples/maps/sankey-map-with-waypoints.md +6 -4
- package/extended/examples/maps/satellite-image-globe.md +18 -4
- package/extended/examples/maps/saturn-and-its-rings.md +6 -4
- package/extended/examples/maps/selecting-multiple-areas-map.md +6 -4
- package/extended/examples/maps/solar-eclipse-map.md +6 -4
- package/extended/examples/maps/star-atlas.md +6 -4
- package/extended/examples/maps/trumps-reciprocal-tariffs-map.md +6 -4
- package/extended/examples/maps/us-congressional-districts.md +6 -4
- package/extended/examples/maps/us-heat-map.md +6 -4
- package/extended/examples/maps/weather-map.md +13 -11
- package/extended/examples/maps/world-map-with-clustered-points.md +6 -4
- package/extended/examples/maps/world-time-zone-map.md +6 -4
- package/extended/examples/maps/zooming-to-countries-map.md +6 -4
- package/extended/examples/miscellaneous/angled-word-cloud.md +6 -4
- package/extended/examples/miscellaneous/annotating-charts.md +6 -4
- package/extended/examples/miscellaneous/changing-data-word-cloud.md +6 -4
- package/extended/examples/miscellaneous/combined-bullet-column-line-chart.md +6 -4
- package/extended/examples/miscellaneous/complex-venn-diagram.md +6 -4
- package/extended/examples/miscellaneous/exporting-chart-to-image.md +6 -4
- package/extended/examples/miscellaneous/forest-plot.md +6 -4
- package/extended/examples/miscellaneous/historical-population-pyramid.md +6 -4
- package/extended/examples/miscellaneous/honeycomb-tile-map.md +6 -4
- package/extended/examples/miscellaneous/horizontally-stacked-axes.md +6 -4
- package/extended/examples/miscellaneous/hybrid-drill-down-pie-bar-chart.md +21 -4
- package/extended/examples/miscellaneous/infographic.md +6 -4
- package/extended/examples/miscellaneous/mekko.md +6 -4
- package/extended/examples/miscellaneous/micro-charts-sparklines.md +5 -5
- package/extended/examples/miscellaneous/pictogram.md +6 -4
- package/extended/examples/miscellaneous/population-pyramid.md +6 -4
- package/extended/examples/miscellaneous/progress-chart.md +6 -4
- package/extended/examples/miscellaneous/range-bullet-chart.md +6 -4
- package/extended/examples/miscellaneous/sentence-cloud.md +6 -4
- package/extended/examples/miscellaneous/shaped-word-cloud.md +7 -4
- package/extended/examples/miscellaneous/spectrum-chart.md +6 -4
- package/extended/examples/miscellaneous/strip-plot.md +6 -4
- package/extended/examples/miscellaneous/tag-cloud.md +6 -4
- package/extended/examples/miscellaneous/tile-map.md +6 -4
- package/extended/examples/miscellaneous/venn-diagram-with-patterns.md +6 -4
- package/extended/examples/miscellaneous/venn-diagram.md +6 -4
- package/extended/examples/miscellaneous/vertically-stacked-axes-chart.md +6 -4
- package/extended/examples/miscellaneous/violin-chart.md +6 -4
- package/extended/examples/miscellaneous/word-cloud.md +6 -4
- package/extended/examples/pie-donut/animated-time-line-pie-chart.md +6 -4
- package/extended/examples/pie-donut/donut-chart.md +6 -4
- package/extended/examples/pie-donut/donut-with-radial-gradient.md +6 -4
- package/extended/examples/pie-donut/dragging-pie-slices.md +6 -4
- package/extended/examples/pie-donut/grained-gradient-pie.md +6 -4
- package/extended/examples/pie-donut/nested-donut-chart.md +6 -4
- package/extended/examples/pie-donut/pie-chart-broken-slices.md +6 -4
- package/extended/examples/pie-donut/pie-chart-with-legend.md +6 -4
- package/extended/examples/pie-donut/pie-chart.md +6 -4
- package/extended/examples/pie-donut/pie-of-a-pie.md +6 -4
- package/extended/examples/pie-donut/semi-circle-pie-chart.md +6 -4
- package/extended/examples/pie-donut/simple-pie-chart.md +6 -4
- package/extended/examples/pie-donut/two-level-pie-chart.md +6 -4
- package/extended/examples/pie-donut/two-pie-charts-with-single-legend.md +6 -4
- package/extended/examples/pie-donut/variable-radius-nested-donut-chart.md +6 -4
- package/extended/examples/pie-donut/variable-radius-nested-pie.md +6 -4
- package/extended/examples/pie-donut/variable-radius-pie-chart.md +6 -4
- package/extended/examples/radar-polar/flower-chart.md +6 -4
- package/extended/examples/radar-polar/live-sorting-of-radar-columns.md +6 -4
- package/extended/examples/radar-polar/polar-area-chart.md +6 -4
- package/extended/examples/radar-polar/polar-chart.md +6 -4
- package/extended/examples/radar-polar/polar-scatter.md +6 -4
- package/extended/examples/radar-polar/radar-chart-visualizing-yearly-activities.md +16 -4
- package/extended/examples/radar-polar/radar-chart.md +6 -4
- package/extended/examples/radar-polar/radar-heat-map.md +6 -4
- package/extended/examples/radar-polar/radar-timeline.md +7 -4
- package/extended/examples/radar-polar/radar-with-date-axis.md +6 -4
- package/extended/examples/radar-polar/radial-bar-chart.md +6 -4
- package/extended/examples/radar-polar/radial-histogram.md +6 -4
- package/extended/examples/radar-polar/radial-line-graph.md +10 -6
- package/extended/examples/radar-polar/radial-ridgeline-chart.md +8 -4
- package/extended/examples/radar-polar/stacked-area-radar.md +6 -4
- package/extended/examples/radar-polar/variable-radius-radar.md +6 -4
- package/extended/examples/radar-polar/wheel-of-life.md +6 -4
- package/extended/examples/radar-polar/zoomable-radar.md +6 -4
- package/extended/examples/stock/changing-data-granularity.md +4 -4
- package/extended/examples/stock/live-stock-data.md +4 -4
- package/extended/examples/stock/separate-volume-panel.md +4 -4
- package/extended/examples/stock/stock-chart-comparing-prices.md +4 -4
- package/extended/examples/stock/stock-chart-with-bollinger-bands-indicator.md +4 -4
- package/extended/examples/stock/stock-chart-with-relative-strength-index.md +4 -4
- package/extended/examples/stock/stock-chart-with-volume-profile.md +4 -4
- package/extended/examples/stock/stock-chart.md +4 -4
- package/extended/examples/stock/stock-data-grouping.md +4 -4
- package/extended/examples/stock/stock-intraday-data.md +4 -4
- package/extended/examples/timeline/horizontal-serpentine-timeline.md +6 -4
- package/extended/examples/timeline/infinity-timeline.md +6 -4
- package/extended/examples/timeline/linear-process-diagram.md +19 -5
- package/extended/examples/timeline/serpentine-timeline-chart.md +6 -4
- package/extended/examples/timeline/spiral-timeline.md +6 -4
- package/extended/examples/timeline/stadium-track-chart.md +6 -4
- package/extended/examples/xy-bubble/animated-xy-bubble-timeline-chart.md +6 -4
- package/extended/examples/xy-bubble/beeswarm.md +6 -4
- package/extended/examples/xy-bubble/bubble-based-heat-map.md +6 -4
- package/extended/examples/xy-bubble/bubble-chart-with-pie-bullets.md +6 -4
- package/extended/examples/xy-bubble/bubble-chart.md +6 -4
- package/extended/examples/xy-bubble/irregular-interval-xy.md +6 -4
- package/extended/examples/xy-bubble/motion-chart.md +7 -5
- package/extended/examples/xy-bubble/scatter-chart.md +6 -4
- package/extended/examples/xy-bubble/scatter-plot-with-tens-of-thousands-points.md +6 -4
- package/extended/examples/xy-bubble/xy-chart-date-based-axis.md +6 -4
- package/extended/examples/xy-bubble/xy-chart-fills-axis.md +6 -4
- package/extended/examples/xy-bubble/xy-chart-value-based-line-graphs.md +6 -4
- package/extended/examples/xy-bubble/xy-error-chart.md +6 -4
- package/extended/examples/xy-bubble/zoomable-bubble-chart.md +6 -4
- package/extended/getting-started/integrations/am5-chart-element.md +212 -22
- package/extended/getting-started/integrations/cypress.md +14 -12
- package/extended/getting-started/integrations/ember-js.md +29 -30
- package/extended/getting-started/integrations/jest.md +8 -6
- package/extended/getting-started/integrations/next-js.md +11 -5
- package/extended/getting-started/integrations/nuxt.md +24 -4
- package/extended/getting-started/integrations/react.md +2 -4
- package/extended/getting-started/integrations/remix-3.md +8 -6
- package/extended/getting-started/integrations/remix.md +14 -6
- package/extended/getting-started/integrations.md +9 -9
- package/extended/getting-started/root-element.md +5 -572
- package/extended/migrating-from-amcharts-4.md +14 -19
- package/extended/reference/accelerationbands.md +15 -0
- package/extended/reference/accumulationdistribution.md +11 -0
- package/extended/reference/accumulativeswingindex.md +11 -0
- package/extended/reference/adapters.md +7 -0
- package/extended/reference/animatedtheme.md +6 -0
- package/extended/reference/animation.md +7 -0
- package/extended/reference/animationtime.md +6 -0
- package/extended/reference/annotator.md +16 -0
- package/extended/reference/arc.md +5 -0
- package/extended/reference/arcdiagram.md +12 -0
- package/extended/reference/arcdiagramlink.md +12 -0
- package/extended/reference/arcdiagramnodes.md +12 -0
- package/extended/reference/arcto.md +10 -0
- package/extended/reference/aroon.md +11 -0
- package/extended/reference/arraydisposer.md +6 -0
- package/extended/reference/averageseries.md +14 -0
- package/extended/reference/averagetruerange.md +11 -0
- package/extended/reference/awesomeoscillator.md +11 -0
- package/extended/reference/axis.md +22 -0
- package/extended/reference/axisbullet.md +7 -0
- package/extended/reference/axislabel.md +10 -0
- package/extended/reference/axislabelradial.md +11 -0
- package/extended/reference/axisrenderer.md +14 -0
- package/extended/reference/axisrenderercircular.md +15 -0
- package/extended/reference/axisrenderercurvex.md +19 -0
- package/extended/reference/axisrenderercurvey.md +15 -0
- package/extended/reference/axisrendererradial.md +14 -0
- package/extended/reference/axisrendererx.md +13 -0
- package/extended/reference/axisrenderery.md +13 -0
- package/extended/reference/axistick.md +8 -0
- package/extended/reference/basecolumnseries.md +18 -0
- package/extended/reference/beginfill.md +6 -0
- package/extended/reference/begingroup.md +6 -0
- package/extended/reference/beginpath.md +6 -0
- package/extended/reference/benchmark.md +5 -0
- package/extended/reference/beziercurveto.md +5 -0
- package/extended/reference/bollingerbands.md +15 -0
- package/extended/reference/breadcrumbbar.md +9 -0
- package/extended/reference/bullbearpower.md +11 -0
- package/extended/reference/bullet.md +7 -0
- package/extended/reference/button.md +9 -0
- package/extended/reference/calloutseries.md +15 -0
- package/extended/reference/candlestick.md +8 -0
- package/extended/reference/candlestickseries.md +13 -0
- package/extended/reference/canvaslayer.md +5 -0
- package/extended/reference/canvasrenderer.md +31 -0
- package/extended/reference/categoryaxis.md +27 -0
- package/extended/reference/categorydateaxis.md +17 -0
- package/extended/reference/chaikinmoneyflow.md +11 -0
- package/extended/reference/chaikinoscillator.md +11 -0
- package/extended/reference/chart.md +9 -0
- package/extended/reference/chartelement.md +6 -0
- package/extended/reference/chartindicator.md +15 -0
- package/extended/reference/chartserializer.md +13 -0
- package/extended/reference/children.md +11 -0
- package/extended/reference/chord.md +12 -0
- package/extended/reference/chorddirected.md +12 -0
- package/extended/reference/chordlink.md +12 -0
- package/extended/reference/chordlinkdirected.md +9 -0
- package/extended/reference/chordnodes.md +12 -0
- package/extended/reference/chordnonribbon.md +12 -0
- package/extended/reference/circle.md +8 -0
- package/extended/reference/circlepattern.md +7 -0
- package/extended/reference/clockhand.md +9 -0
- package/extended/reference/closepath.md +10 -0
- package/extended/reference/clusteredpointseries.md +16 -0
- package/extended/reference/color.md +23 -7
- package/extended/reference/colorblinddarktheme.md +6 -0
- package/extended/reference/colorblindtheme.md +6 -0
- package/extended/reference/colorcontrol.md +14 -0
- package/extended/reference/colorpicker.md +13 -0
- package/extended/reference/colorpickerbutton.md +9 -0
- package/extended/reference/colorpickerdefaulttheme.md +6 -0
- package/extended/reference/colorset.md +13 -0
- package/extended/reference/columnseries.md +13 -0
- package/extended/reference/commoditychannelindex.md +11 -0
- package/extended/reference/comparisoncontrol.md +9 -0
- package/extended/reference/component.md +19 -0
- package/extended/reference/confirmbutton.md +9 -0
- package/extended/reference/container.md +18 -0
- package/extended/reference/counterdisposer.md +10 -0
- package/extended/reference/counterref.md +5 -0
- package/extended/reference/csvparser.md +4 -0
- package/extended/reference/curvechart.md +10 -0
- package/extended/reference/curvecolumnseries.md +13 -0
- package/extended/reference/curvecursor.md +10 -0
- package/extended/reference/curvedefaulttheme.md +6 -0
- package/extended/reference/curvelineseries.md +12 -0
- package/extended/reference/darktheme.md +6 -0
- package/extended/reference/dataitem.md +12 -0
- package/extended/reference/dataprocessor.md +12 -0
- package/extended/reference/datasavecontrol.md +15 -0
- package/extended/reference/datavizdarktheme.md +6 -0
- package/extended/reference/dataviztheme.md +6 -0
- package/extended/reference/dateaxis.md +27 -0
- package/extended/reference/dateformatter.md +12 -0
- package/extended/reference/daterangeselector.md +8 -0
- package/extended/reference/defaulttheme.md +6 -0
- package/extended/reference/disparityindex.md +11 -0
- package/extended/reference/disposer.md +5 -0
- package/extended/reference/disposerclass.md +5 -0
- package/extended/reference/doodleseries.md +13 -0
- package/extended/reference/drawcircle.md +5 -0
- package/extended/reference/drawellipse.md +5 -0
- package/extended/reference/drawingcontrol.md +16 -0
- package/extended/reference/drawingseries.md +37 -0
- package/extended/reference/drawingtoolcontrol.md +12 -0
- package/extended/reference/drawrect.md +5 -0
- package/extended/reference/dropdown.md +15 -0
- package/extended/reference/dropdowncolors.md +12 -0
- package/extended/reference/dropdowncontrol.md +8 -0
- package/extended/reference/dropdownlist.md +14 -0
- package/extended/reference/dropdownlistcontrol.md +14 -0
- package/extended/reference/durationaxis.md +16 -0
- package/extended/reference/durationformatter.md +15 -0
- package/extended/reference/editableaxislabel.md +10 -0
- package/extended/reference/editablelabel.md +10 -0
- package/extended/reference/ellipse.md +8 -0
- package/extended/reference/ellipseseries.md +18 -0
- package/extended/reference/embertheme.md +6 -0
- package/extended/reference/endfill.md +6 -0
- package/extended/reference/endgroup.md +6 -0
- package/extended/reference/endstroke.md +6 -0
- package/extended/reference/entity.md +14 -0
- package/extended/reference/eventdispatcher.md +20 -0
- package/extended/reference/exporting.md +35 -0
- package/extended/reference/exportingmenu.md +13 -0
- package/extended/reference/fibonacciseries.md +14 -0
- package/extended/reference/fibonaccitimezoneseries.md +14 -0
- package/extended/reference/flow.md +16 -0
- package/extended/reference/flowdefaulttheme.md +6 -0
- package/extended/reference/flowlink.md +12 -0
- package/extended/reference/flownode.md +9 -0
- package/extended/reference/flownodes.md +18 -0
- package/extended/reference/forcedirected.md +13 -0
- package/extended/reference/frozendarktheme.md +6 -0
- package/extended/reference/frozentheme.md +6 -0
- package/extended/reference/funnelseries.md +17 -0
- package/extended/reference/funnelslice.md +12 -0
- package/extended/reference/gantt.md +16 -0
- package/extended/reference/ganttcategoryaxis.md +30 -0
- package/extended/reference/ganttcategoryaxisrenderer.md +9 -0
- package/extended/reference/ganttdateaxis.md +13 -0
- package/extended/reference/ganttdateaxisrenderer.md +10 -0
- package/extended/reference/ganttdefaulttheme.md +6 -0
- package/extended/reference/ganttseries.md +28 -0
- package/extended/reference/gaplessdateaxis.md +21 -0
- package/extended/reference/geometrichittester.md +5 -0
- package/extended/reference/ghostlayer.md +8 -0
- package/extended/reference/gradient.md +7 -0
- package/extended/reference/grainpattern.md +7 -0
- package/extended/reference/graphics.md +8 -0
- package/extended/reference/graphicsdata.md +27 -0
- package/extended/reference/graphicsimage.md +10 -0
- package/extended/reference/graticuleseries.md +12 -0
- package/extended/reference/grid.md +8 -0
- package/extended/reference/gridlayout.md +7 -0
- package/extended/reference/heatlegend.md +13 -0
- package/extended/reference/heikinashi.md +11 -0
- package/extended/reference/hierarchy.md +24 -0
- package/extended/reference/hierarchydefaulttheme.md +6 -0
- package/extended/reference/hierarchylink.md +13 -0
- package/extended/reference/hierarchynode.md +9 -0
- package/extended/reference/horizontallayout.md +7 -0
- package/extended/reference/horizontallineseries.md +14 -0
- package/extended/reference/horizontalrayseries.md +14 -0
- package/extended/reference/iconcontrol.md +14 -0
- package/extended/reference/iconseries.md +19 -0
- package/extended/reference/indicator.md +16 -0
- package/extended/reference/indicatorcontrol.md +17 -0
- package/extended/reference/interactionmanager.md +12 -0
- package/extended/reference/interfacecolors.md +7 -0
- package/extended/reference/intervalcontrol.md +9 -0
- package/extended/reference/jsondata.md +5 -0
- package/extended/reference/jsonparser.md +9 -0
- package/extended/reference/kellydarktheme.md +6 -0
- package/extended/reference/kellytheme.md +6 -0
- package/extended/reference/label.md +14 -0
- package/extended/reference/labelboxes.md +5 -0
- package/extended/reference/labelfit.md +5 -0
- package/extended/reference/labelseries.md +18 -0
- package/extended/reference/language.md +18 -0
- package/extended/reference/layout.md +7 -0
- package/extended/reference/legend.md +11 -0
- package/extended/reference/line.md +8 -0
- package/extended/reference/lineargradient.md +7 -0
- package/extended/reference/lineargradientdef.md +4 -0
- package/extended/reference/linearrowseries.md +18 -0
- package/extended/reference/linedash.md +6 -0
- package/extended/reference/linedashoffset.md +6 -0
- package/extended/reference/linepattern.md +7 -0
- package/extended/reference/lineseries.md +12 -0
- package/extended/reference/linestyle.md +6 -0
- package/extended/reference/lineto.md +5 -0
- package/extended/reference/link.md +9 -0
- package/extended/reference/linkedhierarchy.md +20 -0
- package/extended/reference/linkedhierarchynode.md +9 -0
- package/extended/reference/list.md +23 -0
- package/extended/reference/listautodispose.md +12 -0
- package/extended/reference/listdata.md +6 -0
- package/extended/reference/listtemplate.md +7 -0
- package/extended/reference/macd.md +11 -0
- package/extended/reference/macross.md +10 -0
- package/extended/reference/mapchart.md +27 -0
- package/extended/reference/mapchartdefaulttheme.md +6 -0
- package/extended/reference/mapline.md +13 -0
- package/extended/reference/maplineseries.md +15 -0
- package/extended/reference/mappointseries.md +17 -0
- package/extended/reference/mappolygon.md +13 -0
- package/extended/reference/mappolygonseries.md +19 -0
- package/extended/reference/maprasterseries.md +11 -0
- package/extended/reference/mapsankeynodes.md +11 -0
- package/extended/reference/mapsankeyseries.md +18 -0
- package/extended/reference/mapseries.md +11 -0
- package/extended/reference/materialdarktheme.md +6 -0
- package/extended/reference/materialtheme.md +6 -0
- package/extended/reference/matrix.md +9 -0
- package/extended/reference/measure.md +14 -0
- package/extended/reference/medianprice.md +11 -0
- package/extended/reference/microcharttheme.md +6 -0
- package/extended/reference/midnighttheme.md +6 -0
- package/extended/reference/modal.md +14 -0
- package/extended/reference/momentum.md +11 -0
- package/extended/reference/monotonextension.md +8 -0
- package/extended/reference/monotoneytension.md +8 -0
- package/extended/reference/moonrisedarktheme.md +6 -0
- package/extended/reference/moonrisetheme.md +6 -0
- package/extended/reference/moveto.md +5 -0
- package/extended/reference/movingaverage.md +10 -0
- package/extended/reference/movingaveragedeviation.md +11 -0
- package/extended/reference/movingaverageenvelope.md +15 -0
- package/extended/reference/multidisposer.md +6 -0
- package/extended/reference/mutablevaluedisposer.md +12 -0
- package/extended/reference/nightseries.md +12 -0
- package/extended/reference/norddarktheme.md +6 -0
- package/extended/reference/nordtheme.md +6 -0
- package/extended/reference/numberformatter.md +11 -0
- package/extended/reference/numericstepper.md +9 -0
- package/extended/reference/ohlc.md +8 -0
- package/extended/reference/ohlcseries.md +13 -0
- package/extended/reference/onbalancevolume.md +11 -0
- package/extended/reference/op.md +5 -0
- package/extended/reference/orthogonalline.md +12 -0
- package/extended/reference/overboughtoversold.md +11 -0
- package/extended/reference/pack.md +12 -0
- package/extended/reference/panelcontrols.md +9 -0
- package/extended/reference/parallelchannelseries.md +14 -0
- package/extended/reference/partition.md +12 -0
- package/extended/reference/pasteldarktheme.md +6 -0
- package/extended/reference/pasteltheme.md +6 -0
- package/extended/reference/pathpattern.md +7 -0
- package/extended/reference/pattern.md +7 -0
- package/extended/reference/patternsdarktheme.md +6 -0
- package/extended/reference/patternset.md +16 -0
- package/extended/reference/patternstheme.md +6 -0
- package/extended/reference/percent.md +9 -0
- package/extended/reference/percentchart.md +9 -0
- package/extended/reference/percentdefaulttheme.md +6 -0
- package/extended/reference/percentseries.md +20 -0
- package/extended/reference/periodselector.md +12 -0
- package/extended/reference/petroleumtheme.md +6 -0
- package/extended/reference/pictorialstackedseries.md +13 -0
- package/extended/reference/picture.md +8 -0
- package/extended/reference/picturepattern.md +7 -0
- package/extended/reference/piechart.md +14 -0
- package/extended/reference/pieseries.md +12 -0
- package/extended/reference/pixelmapseries.md +18 -0
- package/extended/reference/pointedrectangle.md +8 -0
- package/extended/reference/polygon.md +8 -0
- package/extended/reference/polylineseries.md +19 -0
- package/extended/reference/progresspie.md +9 -0
- package/extended/reference/pvt.md +11 -0
- package/extended/reference/pyramidseries.md +13 -0
- package/extended/reference/quadrantlineseries.md +14 -0
- package/extended/reference/quadraticcurveto.md +5 -0
- package/extended/reference/radarchart.md +10 -0
- package/extended/reference/radarcolumnseries.md +13 -0
- package/extended/reference/radarcursor.md +10 -0
- package/extended/reference/radardefaulttheme.md +6 -0
- package/extended/reference/radarlineseries.md +12 -0
- package/extended/reference/radialgradient.md +7 -0
- package/extended/reference/radialgradientdef.md +4 -0
- package/extended/reference/radiallabel.md +15 -0
- package/extended/reference/radialtext.md +9 -0
- package/extended/reference/rectangle.md +8 -0
- package/extended/reference/rectanglepattern.md +7 -0
- package/extended/reference/rectangleseries.md +14 -0
- package/extended/reference/regressionseries.md +14 -0
- package/extended/reference/relativestrengthindex.md +11 -0
- package/extended/reference/resetcontrol.md +8 -0
- package/extended/reference/resizesensor.md +5 -0
- package/extended/reference/responsivebasetheme.md +16 -0
- package/extended/reference/responsivemaxtheme.md +12 -0
- package/extended/reference/responsivetheme.md +7 -0
- package/extended/reference/root.md +16 -0
- package/extended/reference/roundedrectangle.md +8 -0
- package/extended/reference/sankey.md +12 -0
- package/extended/reference/sankeylink.md +12 -0
- package/extended/reference/sankeynodes.md +12 -0
- package/extended/reference/savannatheme.md +6 -0
- package/extended/reference/scenecontainer.md +15 -0
- package/extended/reference/scenegraphics.md +33 -0
- package/extended/reference/sceneimage.md +12 -0
- package/extended/reference/scenenode.md +24 -0
- package/extended/reference/sceneradialtext.md +8 -0
- package/extended/reference/scenetext.md +12 -0
- package/extended/reference/scrollbar.md +9 -0
- package/extended/reference/serialchart.md +9 -0
- package/extended/reference/serialchartcontainer.md +9 -0
- package/extended/reference/serializer.md +11 -0
- package/extended/reference/series.md +19 -0
- package/extended/reference/seriestypecontrol.md +9 -0
- package/extended/reference/serpentinechart.md +10 -0
- package/extended/reference/settings.md +22 -0
- package/extended/reference/settingscontrol.md +9 -0
- package/extended/reference/settingsmodal.md +16 -0
- package/extended/reference/shadow.md +6 -0
- package/extended/reference/simplelineseries.md +20 -0
- package/extended/reference/slice.md +8 -0
- package/extended/reference/slicedchart.md +9 -0
- package/extended/reference/slicegrouper.md +11 -0
- package/extended/reference/slider.md +9 -0
- package/extended/reference/smoothedradarlineseries.md +12 -0
- package/extended/reference/smoothedxlineseries.md +12 -0
- package/extended/reference/smoothedxylineseries.md +12 -0
- package/extended/reference/smoothedylineseries.md +12 -0
- package/extended/reference/spiralchart.md +10 -0
- package/extended/reference/spiriteddarktheme.md +6 -0
- package/extended/reference/spiritedtheme.md +6 -0
- package/extended/reference/sprite.md +44 -0
- package/extended/reference/spriteeventdispatcher.md +10 -0
- package/extended/reference/spriteresizer.md +9 -0
- package/extended/reference/standarddeviation.md +11 -0
- package/extended/reference/star.md +8 -0
- package/extended/reference/starpattern.md +7 -0
- package/extended/reference/state.md +9 -0
- package/extended/reference/states.md +8 -0
- package/extended/reference/steplineseries.md +12 -0
- package/extended/reference/stochasticmomentumindex.md +11 -0
- package/extended/reference/stochasticoscillator.md +11 -0
- package/extended/reference/stockchart.md +28 -0
- package/extended/reference/stockchartdefaulttheme.md +6 -0
- package/extended/reference/stockcontrol.md +13 -0
- package/extended/reference/stockicons.md +4 -0
- package/extended/reference/stocklegend.md +11 -0
- package/extended/reference/stockpanel.md +17 -0
- package/extended/reference/stocktoolbar.md +7 -0
- package/extended/reference/stylerule.md +10 -0
- package/extended/reference/stylesheet.md +6 -0
- package/extended/reference/sunburst.md +12 -0
- package/extended/reference/sunclock.md +6 -0
- package/extended/reference/supertrend.md +15 -0
- package/extended/reference/svgdefs.md +7 -0
- package/extended/reference/svgdocument.md +11 -0
- package/extended/reference/svglayer.md +4 -0
- package/extended/reference/svgpathsink.md +13 -0
- package/extended/reference/svgrenderer.md +6 -0
- package/extended/reference/targetedeventdispatcher.md +6 -0
- package/extended/reference/template.md +17 -0
- package/extended/reference/templateadapters.md +5 -0
- package/extended/reference/templatestate.md +7 -0
- package/extended/reference/templatestates.md +6 -0
- package/extended/reference/text.md +15 -0
- package/extended/reference/textformatter.md +4 -0
- package/extended/reference/theme.md +5 -0
- package/extended/reference/throttler.md +4 -0
- package/extended/reference/tick.md +8 -0
- package/extended/reference/timezone.md +6 -0
- package/extended/reference/tooltip.md +13 -0
- package/extended/reference/tree.md +20 -0
- package/extended/reference/treemap.md +12 -0
- package/extended/reference/trendlineseries.md +14 -0
- package/extended/reference/triangle.md +8 -0
- package/extended/reference/trianglepattern.md +7 -0
- package/extended/reference/trix.md +11 -0
- package/extended/reference/typicalprice.md +11 -0
- package/extended/reference/value.md +5 -0
- package/extended/reference/valueaxis.md +24 -0
- package/extended/reference/venn.md +19 -0
- package/extended/reference/venndefaulttheme.md +6 -0
- package/extended/reference/verticallayout.md +7 -0
- package/extended/reference/verticallineseries.md +14 -0
- package/extended/reference/volume.md +11 -0
- package/extended/reference/volumeprofile.md +10 -0
- package/extended/reference/voronoitreemap.md +12 -0
- package/extended/reference/vwap.md +10 -0
- package/extended/reference/williamsr.md +11 -0
- package/extended/reference/wordcloud.md +11 -0
- package/extended/reference/wordclouddefaulttheme.md +6 -0
- package/extended/reference/xychart.md +15 -0
- package/extended/reference/xychartdefaulttheme.md +6 -0
- package/extended/reference/xychartscrollbar.md +9 -0
- package/extended/reference/xycursor.md +14 -0
- package/extended/reference/xyseries.md +22 -0
- package/extended/reference/zigzag.md +10 -0
- package/extended/reference/zoomablecontainer.md +16 -0
- package/extended/reference/zoomcontrol.md +9 -0
- package/extended/reference/zoomtools.md +9 -0
- package/package.json +1 -1
- package/src/content.js +10 -2
- package/src/tools.js +33 -6
package/content/SKILL.md
CHANGED
|
@@ -42,10 +42,10 @@ Docs: https://docs.amcharts.com/v5/
|
|
|
42
42
|
10. **CategoryAxis must receive data** — call `xAxis.data.setAll(data)` in addition to series data. Forgetting this is the #1 bug.
|
|
43
43
|
11. **DateAxis values must be timestamps** — use `new Date().getTime()`, not Date objects.
|
|
44
44
|
12. **Disposal is mandatory in SPAs** — in React, Vue, Angular, Svelte or React Native use amCharts' framework package, which creates and disposes the root for you (see "Frameworks"); without one, call `root.dispose()` on component unmount. Not `chart.dispose()`.
|
|
45
|
-
13. **Style through amCharts, not CSS** — charts draw on canvas by default, so CSS cannot reach chart internals. Even with the optional SVG renderer
|
|
45
|
+
13. **Style through amCharts, not CSS** — charts draw on canvas by default, so CSS cannot reach chart internals. Even with the optional SVG renderer the shapes carry no per-element classes or ids, are rewritten as the chart redraws, and exports ignore page CSS. Use amCharts settings/templates/themes instead.
|
|
46
46
|
14. **Dark backgrounds require Dark theme** — If the user requests or the page clearly has a dark background, always add `am5themes_Dark.new(root)` to `root.setThemes()` after Animated and ResponsiveMax. Without it, labels, grid, and tooltips will be invisible. If the background is not clearly dark, default to white/light and do NOT add the Dark theme unless asked.
|
|
47
47
|
15. **Use default amCharts colors** — Do NOT invent custom color palettes unless the user explicitly asks for specific colors. amCharts assigns colors automatically from its built-in ColorSet. If you need a color programmatically, use `chart.get("colors").getIndex(index)` or `chart.get("colors").next()`. For pie/percent charts, use `series.get("colors")` instead. With 3 or more series in one XY chart, the default colors are close blues and violets (hues 18° apart): set `chart.get("colors").set("step", 3)` before adding series, or use the `Colorblind` theme (see "ColorSet").
|
|
48
|
-
16. **Every chart gets `Animated` and `ResponsiveMax
|
|
48
|
+
16. **Every chart gets `Animated` and `ResponsiveMax`** — `root.setThemes([am5themes_Animated.new(root), am5themes_ResponsiveMax.new(root)])`, with a palette or `Dark` theme after them. ResponsiveMax fits labels and legends at any size and adapts the chart on small screens: axis labels are spaced to fit, legends shrink and then scroll, and scrollbars give way to pinch zoom on phones. Import `@amcharts/amcharts5/themes/ResponsiveMax`, or load `themes/ResponsiveMax.js` after `themes/Animated.js`. One exception: a `Micro` sparkline keeps `Micro` alone.
|
|
49
49
|
|
|
50
50
|
## Package / module map
|
|
51
51
|
|
|
@@ -64,27 +64,22 @@ Docs: https://docs.amcharts.com/v5/
|
|
|
64
64
|
| Venn | `@amcharts/amcharts5/venn` | `venn.js` | Venn |
|
|
65
65
|
| Gantt | `@amcharts/amcharts5/gantt` | `gantt.js` | Gantt (also needs `xy.js` and `plugins/colorPicker.js`, both before `gantt.js`) |
|
|
66
66
|
| Geodata | `@amcharts/amcharts5-geodata/*` | `geodata/*.js` | worldLow, usaLow, etc. |
|
|
67
|
-
| Themes | `@amcharts/amcharts5/themes/Animated`, `@amcharts/amcharts5/themes/ResponsiveMax`
|
|
67
|
+
| Themes | `@amcharts/amcharts5/themes/Animated`, `@amcharts/amcharts5/themes/ResponsiveMax` | `themes/Animated.js`, `themes/ResponsiveMax.js` | am5themes_Animated, am5themes_ResponsiveMax |
|
|
68
68
|
| Exporting | `@amcharts/amcharts5/plugins/exporting` | `plugins/exporting.js` | Exporting, ExportingMenu |
|
|
69
69
|
| JSON | `@amcharts/amcharts5/plugins/json` | `plugins/json.js` | ChartSerializer, JsonParser |
|
|
70
|
-
| Chart element
|
|
70
|
+
| Chart element | `@amcharts/amcharts5/element` | `element.js` (after `plugins/json.js`) | `<am5-chart>` — see "Serializing to JSON" |
|
|
71
71
|
| Framework packages | `@amcharts/amcharts5-react`, `-vue`, `-angular`, `-svelte`, `-react-native` (separate npm packages) | — | `useAmChart`, `<AmChart>`, `[amChart]`, `attachAmChart` — see "Frameworks" |
|
|
72
72
|
|
|
73
|
-
**Plain HTML, no bundler.** Load the script files ("CDN script" above) with `<script>` tags: `index.js` first, then the chart packages, then themes. They are on the amCharts CDN (`https://cdn.amcharts.com/lib/5/index.js`), and
|
|
74
|
-
|
|
75
|
-
```html
|
|
76
|
-
<script src="https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/index.js"></script>
|
|
77
|
-
<script src="https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/xy.js"></script>
|
|
78
|
-
<script src="https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/themes/Animated.js"></script>
|
|
79
|
-
<script src="https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/themes/ResponsiveMax.js"></script>
|
|
80
|
-
```
|
|
73
|
+
**Plain HTML, no bundler.** Load the script files ("CDN script" above) with `<script>` tags: `index.js` first, then the chart packages, then themes. They are on the amCharts CDN (`https://cdn.amcharts.com/lib/5/index.js`), and in the npm package's `dist/` folder, so npm CDNs serve them. On jsDelivr they are under `https://cdn.jsdelivr.net/npm/@amcharts/amcharts5@5.22.0/dist/`, with the same file names: `index.js`, `xy.js`, `themes/Animated.js`, `themes/ResponsiveMax.js`.
|
|
81
74
|
|
|
82
75
|
- **Which CDN:** cdn.amcharts.com by default. Where only npm CDNs are allowed (Claude artifacts and other AI sandboxes, strict CSPs), use jsDelivr or unpkg (`https://unpkg.com/@amcharts/amcharts5@5.22.0/dist/index.js`). The files are also at `node_modules/@amcharts/amcharts5/dist/`.
|
|
83
76
|
- **Pin one version for every file,** and use classic script tags, not `type="module"`: the lazy parts (PDF, Excel and annotation export) load from the `deps/` folder beside `index.js`.
|
|
84
77
|
- **Maps:** the package's `dist/geodata/` has only `worldLow.js` and `usaLow.js`. Other maps are in the `@amcharts/amcharts5-geodata` package's `dist/`, at the same path as below `geodata/` on the amCharts CDN (`dist/worldLow.js`, `dist/region/world/europeLow.js`), on unpkg (`https://unpkg.com/@amcharts/amcharts5-geodata@5.2.0/dist/worldLow.js`) but not jsDelivr, which refuses a package that large.
|
|
85
78
|
- **PDF fonts** (`am5fonts_*`) are only on cdn.amcharts.com.
|
|
86
79
|
|
|
87
|
-
**Bundling.** Keep code splitting on (esbuild: `splitting: true`, `format: "esm"`). With the stock toolbar's drawing or indicator controls, `<am5-chart>`, the JSON plugin or the exporting plugin, a single-file bundle inlines the exporting plugin's lazy parts (PDF, Excel, annotations), about 1 MB gzipped more: a stock chart with those controls loads about 275 KB gzipped split, 1.4 MB as one file (the toolbar itself and `PeriodSelector` add almost nothing). So does `import * as am5stock` when the whole namespace object is kept (assigned to a variable or `window`); `am5stock.StockChart` and the like keep only what they use. A stock chart without those controls bundles to about 130–200 KB, core + `xy` to about 170 KB. The script files gzipped
|
|
80
|
+
**Bundling.** Keep code splitting on (esbuild: `splitting: true`, `format: "esm"`). With the stock toolbar's drawing or indicator controls, `<am5-chart>`, the JSON plugin or the exporting plugin, a single-file bundle inlines the exporting plugin's lazy parts (PDF, Excel, annotations), about 1 MB gzipped more: a stock chart with those controls loads about 275 KB gzipped split, 1.4 MB as one file (the toolbar itself and `PeriodSelector` add almost nothing). So does `import * as am5stock` when the whole namespace object is kept (assigned to a variable or `window`); `am5stock.StockChart` and the like keep only what they use. A stock chart without those controls bundles to about 130–200 KB, core + `xy` to about 170 KB. The script files gzipped: `index.js` + `xy.js` 182 KB, + `stock.js` 260 KB. Docs: https://docs.amcharts.com/v5/getting-started/#bundling.
|
|
81
|
+
|
|
82
|
+
**The npm package also ships** `AGENTS.md`, `docs/` (a bundled copy of these notes, possibly older) and `examples/<name>/index.ts` (62 also as `config.json`; `examples/examples.json` lists what each shows). When the package is installed, those examples are verified starting points.
|
|
88
83
|
|
|
89
84
|
## Which reference to read
|
|
90
85
|
|
|
@@ -115,7 +110,7 @@ If the user asks about core setup (theming, colors, exporting, legends, tooltips
|
|
|
115
110
|
```js
|
|
116
111
|
const root = am5.Root.new("chartdiv"); // div id or HTMLElement reference
|
|
117
112
|
|
|
118
|
-
// Apply theme(s): Animated and ResponsiveMax on every chart
|
|
113
|
+
// Apply theme(s): Animated and ResponsiveMax on every chart; a palette or Dark after them
|
|
119
114
|
root.setThemes([am5themes_Animated.new(root), am5themes_ResponsiveMax.new(root)]);
|
|
120
115
|
|
|
121
116
|
// Set locale (optional)
|
|
@@ -125,11 +120,15 @@ root.locale = am5locales_de_DE;
|
|
|
125
120
|
// Set date/number formats (optional)
|
|
126
121
|
root.dateFormatter.setAll({ dateFormat: "yyyy-MM-dd" });
|
|
127
122
|
root.numberFormatter.setAll({ numberFormat: "#,###.##" });
|
|
123
|
+
|
|
124
|
+
// Time zone (optional): date axes, formatters, data grouping and the stock
|
|
125
|
+
// PeriodSelector/DateRangeSelector follow it; root.utc = true for UTC
|
|
126
|
+
root.timezone = am5.Timezone.new("America/New_York");
|
|
128
127
|
```
|
|
129
128
|
|
|
130
129
|
One Root per DOM element: a second `am5.Root.new()` on the same element throws "You cannot have multiple Roots on the same DOM node", so dispose the old root first. Separate elements on one page can each have their own Root (for example, a chart in a modal), and each is disposed on its own.
|
|
131
130
|
|
|
132
|
-
**Canvas or SVG
|
|
131
|
+
**Canvas or SVG.** Charts draw on canvas by default. `am5.SVGRenderer` draws the same chart as live SVG instead — it can only be chosen when the root is created:
|
|
133
132
|
|
|
134
133
|
```js
|
|
135
134
|
const root = am5.Root.new("chartdiv", { renderer: am5.SVGRenderer });
|
|
@@ -139,14 +138,14 @@ am5.Root.defaultRenderer = am5.SVGRenderer;
|
|
|
139
138
|
|
|
140
139
|
Charts look and behave the same with either (text is measured the same way, interaction and image export work as usual); only blend modes `DST_OVER`, `SRC_ATOP` and `XOR` are canvas-only (drawn as normal in SVG, with a console warning). Keep the canvas default unless the user asks for SVG in the page. An SVG **file** does not need it — `am5.renderToSVG()` and the exporting menu make SVG from either renderer (see "Exporting"). In SVG mode pointer input is still resolved by amCharts (the `<svg>` layers have `pointer-events="none"`), so attach handlers with `events.on()`, not DOM listeners.
|
|
141
140
|
|
|
142
|
-
**Available themes
|
|
141
|
+
**Available themes:**
|
|
143
142
|
|
|
144
143
|
| Kind | Themes |
|
|
145
144
|
|------|--------|
|
|
146
|
-
| Behavioral | `Animated` (animations), `ResponsiveMax` (
|
|
145
|
+
| Behavioral | `Animated` (animations), `ResponsiveMax` (on every chart: fits labels, legends and scrollbars; see "Responsive rules"), `Micro` (stripped-down micro charts, alone), `Responsive` (a size-based theme, which mostly hides parts on small charts) |
|
|
147
146
|
| Light palettes | `Dataviz`, `Frozen`, `Kelly`, `Material`, `Moonrise`, `Spirited`, `Ember`, `Nord`, `Pastel`, `Petroleum`, `Savanna`, `Colorblind` (Okabe-Ito, color-blindness safe), `Patterns` (pattern fills instead of flat colors) |
|
|
148
147
|
| Dark | `Dark`, `Midnight`, plus a dark variant of most palettes: `DatavizDark`, `FrozenDark`, `KellyDark`, `MaterialDark`, `MoonriseDark`, `SpiritedDark`, `NordDark`, `PastelDark`, `ColorblindDark`, `PatternsDark` |
|
|
149
|
-
| Parameterized
|
|
148
|
+
| Parameterized | `Monochrome`, `Adaptive` — see below |
|
|
150
149
|
|
|
151
150
|
Palette themes are additive: put them after `Animated` and `ResponsiveMax`, e.g. `root.setThemes([am5themes_Animated.new(root), am5themes_ResponsiveMax.new(root), am5themes_Nord.new(root)])`. The `*Dark` variants already carry dark interface colors, so do NOT also add `Dark`.
|
|
152
151
|
|
|
@@ -180,12 +179,12 @@ chart.get("colors").set("colors", [
|
|
|
180
179
|
am5.color(0xbb9f06)
|
|
181
180
|
]);
|
|
182
181
|
|
|
183
|
-
// A color on a scale through several colors
|
|
182
|
+
// A color on a scale through several colors: position 0–1, clamped, colors evenly spaced; a third argument "hsl" blends in HSL (default "rgb")
|
|
184
183
|
var ic = root.interfaceColors;
|
|
185
184
|
var mid = am5.Color.interpolateColors(0.5, [ic.get("negative"), ic.get("warning"), ic.get("positive")]); // = warning
|
|
186
185
|
```
|
|
187
186
|
|
|
188
|
-
The interface color `warning`
|
|
187
|
+
The interface color `warning` is a yellow between `negative` (red) and `positive` (green), for the middle of a bad-to-good scale. Prefer `interpolateColors()` through it over `am5.Color.interpolate(t, negative, positive)`, whose middle is brown.
|
|
189
188
|
|
|
190
189
|
## Legend
|
|
191
190
|
|
|
@@ -201,7 +200,7 @@ legend.data.setAll(chart.series.values);
|
|
|
201
200
|
legend.data.setAll(series.dataItems);
|
|
202
201
|
```
|
|
203
202
|
|
|
204
|
-
**A legend that fits: `autoFit: true
|
|
203
|
+
**A legend that fits: `autoFit: true`.** As room runs out, it fits the legend in steps:
|
|
205
204
|
1. Empty value labels give their room back.
|
|
206
205
|
2. A legend that fits at three quarters of its size or more gets smaller.
|
|
207
206
|
3. One that wouldn't fit even then scrolls instead, usually at full size, and item names too wide are shortened.
|
|
@@ -209,7 +208,7 @@ legend.data.setAll(series.dataItems);
|
|
|
209
208
|
|
|
210
209
|
Above or below the chart it takes at most 30% of the chart's height, beside it at most 40% of its width. A `width`, `height`, `maxWidth`, `maxHeight`, `scale` or `verticalScrollbar` you set on the legend is kept. Without it, a long legend below a pie can take the whole chart and leave the pie no room.
|
|
211
210
|
|
|
212
|
-
**A right-to-left chart
|
|
211
|
+
**A right-to-left chart**, for Hebrew or Arabic: set the Root's `direction` when you create it.
|
|
213
212
|
|
|
214
213
|
```js
|
|
215
214
|
const root = am5.Root.new("chartdiv", { direction: "rtl" });
|
|
@@ -220,9 +219,9 @@ const root = am5.Root.new("chartdiv", { direction: "rtl" });
|
|
|
220
219
|
- `"ltr"` keeps everything left to right, e.g. an English chart on a `dir="rtl"` page.
|
|
221
220
|
- Not set, text follows the CSS direction of the chart's element, and legends stay left to right.
|
|
222
221
|
|
|
223
|
-
Set it in `Root.new()` (or a JSON config's `root` section), not later.
|
|
222
|
+
Set it in `Root.new()` (or a JSON config's `root` section), not later. Don't also set `reverseChildren` on legend items: the two undo each other and the legend flips back.
|
|
224
223
|
|
|
225
|
-
A `Label` with a `width` keeps its text inside its box for every `textAlign` and `direction
|
|
224
|
+
A `Label` with a `width` keeps its text inside its box for every `textAlign` and `direction`: `left` and `right` are the box's sides, `start` and `end` follow the direction.
|
|
226
225
|
|
|
227
226
|
## Tooltip
|
|
228
227
|
|
|
@@ -316,7 +315,7 @@ Numbers in `{placeholders}` use `root.numberFormatter`'s `numberFormat` (default
|
|
|
316
315
|
|
|
317
316
|
- The part after `.` decides rounding. With no `.` nothing is rounded, unlike Excel's `#,###`; a format ending in `.` rounds to a whole number. For animated values (`{valueXWorking}` in a bar race) use `'#,###.'`.
|
|
318
317
|
- Every number placeholder gets a thousands separator, so a year `{year}` shows `2,024`. Use `{year.formatNumber('#')}`, or keep the year a string in the data.
|
|
319
|
-
- Positive, negative and zero formats are split by `|`, not `;` (`"#,###;'-'#,###;0"` prints `500;-500;0`). The negative part still gets a minus unless it has the `s` modifier: `"#,###|(#,###s)|'-'"` gives `1,000`, `(1,000)`, `-`.
|
|
318
|
+
- Positive, negative and zero formats are split by `|`, not `;` (`"#,###;'-'#,###;0"` prints `500;-500;0`). The negative part still gets a minus unless it has the `s` modifier: `"#,###|(#,###s)|'-'"` gives `1,000`, `(1,000)`, `-`.
|
|
320
319
|
- On a value axis with fractional steps, a trailing `.` makes duplicate labels (`1, 1, 2, 2`); use `maxPrecision: 0` there.
|
|
321
320
|
|
|
322
321
|
## Chart title
|
|
@@ -363,7 +362,7 @@ const exporting = am5plugins_exporting.Exporting.new(root, {
|
|
|
363
362
|
});
|
|
364
363
|
```
|
|
365
364
|
|
|
366
|
-
**SVG export
|
|
365
|
+
**SVG export** works whichever renderer draws the chart. The `ExportingMenu` lists "SVG" by default (`svgOptions: { disabled: true }` removes it; `svgOptions: { precision: 3 }` sets the decimals); in code use `exporting.download("svg")`, `exporting.getSVG()` (markup) or `exporting.exportSVG()` (data URI). Without the plugin, the core has `am5.renderToSVG()`:
|
|
367
366
|
|
|
368
367
|
```js
|
|
369
368
|
// The chart as last drawn — after a change, wait for the frame to be drawn
|
|
@@ -373,11 +372,11 @@ root.events.once("frameended", function () {
|
|
|
373
372
|
});
|
|
374
373
|
```
|
|
375
374
|
|
|
376
|
-
Options: `width`, `height`, `precision` (default `3`), `idPrefix` (`"am5-"`; vary it when several SVGs share a page), `title` (screen-reader name; default the Root `ariaLabel`), `background` (CSS color; default transparent), `includeNonExportable` (
|
|
375
|
+
Options: `width`, `height`, `precision` (default `3`), `idPrefix` (`"am5-"`; vary it when several SVGs share a page), `title` (screen-reader name; default the Root `ariaLabel`), `background` (CSS color; default transparent), `includeNonExportable` (default `false`: also write elements marked `exportable: false`, such as scrollbar grips). Left out: elements with `exportable: false` (unless `includeNonExportable`), cross-origin images without CORS, and fully transparent elements. The SVG suits design tools such as Figma: fonts are attributes with sizes in pixels, text is placed without `dominant-baseline`, patterns are drawn as shapes, and layers are named after series, data items, axes and the legend.
|
|
377
376
|
|
|
378
377
|
## Responsive rules
|
|
379
378
|
|
|
380
|
-
**`am5themes_ResponsiveMax`
|
|
379
|
+
**`am5themes_ResponsiveMax` goes on every chart** (Critical rule 16). It fits labels and legends at any size, and adapts the chart on small screens, hiding parts only as the last step:
|
|
381
380
|
|
|
382
381
|
```js
|
|
383
382
|
import am5themes_ResponsiveMax from "@amcharts/amcharts5/themes/ResponsiveMax"; // script tag: themes/ResponsiveMax.js
|
|
@@ -408,7 +407,7 @@ The settings also work on their own. All are off by default:
|
|
|
408
407
|
|
|
409
408
|
`ChartSerializer` saves these settings when you set them in code. It does not save what they decide (hidden labels, a smaller legend, the pinch zoom), nor what a theme turns on, so a config saved from a small chart opens full size.
|
|
410
409
|
|
|
411
|
-
**Rules of your own** go on the `am5themes_ResponsiveMax` instance (
|
|
410
|
+
**Rules of your own** go on the `am5themes_ResponsiveMax` instance (`am5themes_Responsive` takes them too, but also hides parts of its own):
|
|
412
411
|
|
|
413
412
|
```js
|
|
414
413
|
const responsive = am5themes_ResponsiveMax.new(root);
|
|
@@ -447,7 +446,7 @@ series.set("heatRules", [{
|
|
|
447
446
|
key: "radius"
|
|
448
447
|
}]);
|
|
449
448
|
|
|
450
|
-
// Through more than two values
|
|
449
|
+
// Through more than two values: `stops` in place of min/max, e.g. red–yellow–green
|
|
451
450
|
var ic = root.interfaceColors;
|
|
452
451
|
series.set("heatRules", [{
|
|
453
452
|
target: series.columns.template,
|
|
@@ -469,9 +468,9 @@ A `radius` rule is linear in radius: areas grow with the square of the value, an
|
|
|
469
468
|
| `min` | color/number | Value applied at the lowest data value |
|
|
470
469
|
| `max` | color/number | Value applied at the highest data value |
|
|
471
470
|
| `neutral` | color/number | Value for elements whose data item has no value (otherwise they keep the template's) |
|
|
472
|
-
| `stops` | array | Values for a scale through more than two
|
|
473
|
-
| `minValue` | number | Override auto-calculated min (skips `calculateAggregates`; `0` is honored
|
|
474
|
-
| `maxValue` | number | Override auto-calculated max (skips `calculateAggregates`; `0` is honored
|
|
471
|
+
| `stops` | array | Values for a scale through more than two, in place of `min`/`max`: the lowest data value gets the first, the highest the last, blended between. Numbers, percents or colors, all of one kind |
|
|
472
|
+
| `minValue` | number | Override auto-calculated min (skips `calculateAggregates`; `0` is honored) |
|
|
473
|
+
| `maxValue` | number | Override auto-calculated max (skips `calculateAggregates`; `0` is honored) |
|
|
475
474
|
| `customFunction` | function | `(sprite, min, max, value)` — full control over the rule |
|
|
476
475
|
|
|
477
476
|
**Using heat rules on bullets** — bullets need an explicit `am5.Template`, and the series must track the field the rule reads:
|
|
@@ -502,7 +501,7 @@ Rules that make bullet heat rules work (each failure is **silent** — every bul
|
|
|
502
501
|
- `dataField` is the data item **property key** (`"valueY"`, `"valueX"`, `"value"`, …), **not** the raw column name. To size XY bullets by a column that is not already an axis value, register it as the base value field: `series.set("valueField", "population")` and use `dataField: "value"`.
|
|
503
502
|
- `calculateAggregates: true` is required (unless `minValue`/`maxValue` are given) — without it `valueLow`/`valueHigh` are never computed and every bullet gets the midpoint size.
|
|
504
503
|
- Setting `valueField` (or any `*Field`) **after** the series has processed data does not re-read the data — re-set it: `series.data.setAll(series.data.values.slice())`.
|
|
505
|
-
- Bullet heat rules survive `ChartSerializer
|
|
504
|
+
- Bullet heat rules survive `ChartSerializer`.
|
|
506
505
|
|
|
507
506
|
**HeatLegend:**
|
|
508
507
|
|
|
@@ -520,7 +519,7 @@ series.events.on("datavalidated", function() {
|
|
|
520
519
|
heatLegend.set("endValue", series.getPrivate("valueHigh"));
|
|
521
520
|
});
|
|
522
521
|
|
|
523
|
-
// Through several colors
|
|
522
|
+
// Through several colors: `colors` in place of startColor/endColor, matching a heat rule's `stops`
|
|
524
523
|
var ic = root.interfaceColors;
|
|
525
524
|
var scaleLegend = chart.children.push(am5.HeatLegend.new(root, {
|
|
526
525
|
orientation: "horizontal",
|
|
@@ -538,7 +537,7 @@ series.appear(1000); // duration in ms
|
|
|
538
537
|
chart.appear(1000, 100); // duration, delay
|
|
539
538
|
```
|
|
540
539
|
|
|
541
|
-
**`autoAppear
|
|
540
|
+
**`autoAppear`** — the same opening animation as a setting, so it works from a JSON config or `<am5-chart>`, where `appear()` cannot be called:
|
|
542
541
|
|
|
543
542
|
```js
|
|
544
543
|
chart.setAll({ autoAppear: true, appearDuration: 1000, appearDelay: 100 });
|
|
@@ -548,7 +547,7 @@ series.setAll({ autoAppear: true, appearDuration: 1000 }); // a series waits f
|
|
|
548
547
|
|
|
549
548
|
It plays once, when the element is first drawn (data updates do not replay it; turning the setting off and on does). `autoAppear` defaults to `false`; `appearDuration` falls back to the element's `stateAnimationDuration`; `appearDelay` (default `0`) keeps the element hidden until it starts. Elements made from a template play as each is made; an element that starts hidden stays hidden.
|
|
550
549
|
|
|
551
|
-
**Declared animations — the `animations` setting
|
|
550
|
+
**Declared animations — the `animations` setting.** Every element can carry its own animations as data, so they live in a JSON config and survive `ChartSerializer` — prefer this over `sprite.animate({ loops: Infinity })` for endless effects:
|
|
552
551
|
|
|
553
552
|
```js
|
|
554
553
|
series.bullets.push(function (root, series, dataItem) {
|
|
@@ -621,9 +620,9 @@ whenRendered(root, function () { /* everything is drawn */ });
|
|
|
621
620
|
|
|
622
621
|
With `root.fps` set, frames are spaced `1000 / root.fps` ms apart, so wait longer than that instead of two animation frames. Endless animations (`loops: Infinity` with `animate()`, `loops: 0` in declared `animations`) never settle. Without a license, the amCharts logo fades in 3 s after the root is created and draws for 1.5 s; a check during that time waits for it.
|
|
623
622
|
|
|
624
|
-
**Opening a link on click needs no handler
|
|
623
|
+
**Opening a link on click needs no handler:** `series.set("urlField", "url")` makes each item's bullet, column, slice, Venn slice, map polygon or map line open the URL in its data row (`linkTarget`, default `"_self"`) — see "Recent API changes". Hierarchy nodes, flow nodes/links and word-cloud labels are not linked; keep a `click` handler there.
|
|
625
624
|
|
|
626
|
-
**A tap fires no DOM `click` on a pannable chart.** On touch, a tap on an XYChart with `panX`/`panY`, under a cursor with a zoom or select `behavior`, or on a `draggable` sprite gives `pointerdown`/`pointerup` but no `mousedown`/`mouseup`/`click` on the page (Chrome touch emulation
|
|
625
|
+
**A tap fires no DOM `click` on a pannable chart.** On touch, a tap on an XYChart with `panX`/`panY`, under a cursor with a zoom or select `behavior`, or on a `draggable` sprite gives `pointerdown`/`pointerup` but no `mousedown`/`mouseup`/`click` on the page (Chrome touch emulation). The amCharts `click` event still fires: use `events.on("click", …)`, not a DOM listener.
|
|
627
626
|
|
|
628
627
|
## Settings API
|
|
629
628
|
|
|
@@ -646,12 +645,12 @@ const cursor = chart.set("cursor", am5xy.XYCursor.new(root, {}));
|
|
|
646
645
|
|
|
647
646
|
## Settings that already equal the default — omit them
|
|
648
647
|
|
|
649
|
-
Generated code routinely spells out settings that equal the amCharts default (verified against the default themes, and for `Gantt` the code
|
|
648
|
+
Generated code routinely spells out settings that equal the amCharts default (verified against the default themes, and for `Gantt` the code). They add noise and mislead readers into thinking they matter. Do not emit these unless changing them:
|
|
650
649
|
|
|
651
650
|
| Class | Setting(s) that are already the default |
|
|
652
651
|
|-------|------------------------------------------|
|
|
653
652
|
| All hierarchy series | `childDataField: "children"`, `downDepth: 1`, `initialDepth: 5` |
|
|
654
|
-
| `Sunburst`, `Partition`, `Treemap`, `VoronoiTreemap` | `singleBranchOnly: true` (`Partition`/`Treemap` also `upDepth: 0`; `VoronoiTreemap` also `shapeType: "polygon"`; `Sunburst` ignores the setting
|
|
653
|
+
| `Sunburst`, `Partition`, `Treemap`, `VoronoiTreemap` | `singleBranchOnly: true` (`Partition`/`Treemap` also `upDepth: 0`; `VoronoiTreemap` also `shapeType: "polygon"`; `Sunburst` ignores the setting — always single-branch) |
|
|
655
654
|
| `Tree`, `ForceDirected` | `singleBranchOnly: false`, `upDepth: Infinity`, `topDepth: 0` (`Tree` also `orientation: "vertical"`) |
|
|
656
655
|
| `PieSeries`, `FunnelSeries`, `PyramidSeries`, `PictorialStackedSeries` | `alignLabels: true` (`PieSeries` also `startAngle: -90`, `endAngle: 270`; `FunnelSeries` also `orientation: "vertical"`, `startLocation: 0`, `endLocation: 1`, `bottomRatio: 0`) |
|
|
657
656
|
| `Chord` | `sort: "none"` (data order) |
|
|
@@ -704,7 +703,7 @@ On maps it is worse: a `geometry` can't be animated, so with `setIndex` it switc
|
|
|
704
703
|
|
|
705
704
|
A data item's bullets are a plain array **property**: `dataItem.bullets?.[0]?.get("sprite")` is the sprite the bullet function made (`dataItem.get("bullets")` is `undefined`).
|
|
706
705
|
|
|
707
|
-
`dataItem.bullets` stays `undefined` until the series draws that item: right after `data.setAll()`, in `datavalidated` and in the first `frameended` (
|
|
706
|
+
`dataItem.bullets` stays `undefined` until the series draws that item: right after `data.setAll()`, in `datavalidated` and in the first `frameended` (bullets appear on the second frame), and, on a zoomed `DateAxis`, for items out of view. Decide a bullet's look inside the bullet function from `dataItem` (or with `templateField`), not by reaching into `dataItem.bullets` after setting the data.
|
|
708
707
|
|
|
709
708
|
## Performance: big data, fast updates, no animation
|
|
710
709
|
|
|
@@ -761,7 +760,7 @@ polygon.states.lookup("default")?.set("fill", color);
|
|
|
761
760
|
|
|
762
761
|
**`sprite.hover()` also shows the sprite's tooltip.** To highlight other elements from an event (related links or columns), apply the state instead: `sprite.states.applyAnimate("hover")`, and `"default"` to undo it. Several `hover()` calls move the shared tooltip to the last sprite.
|
|
763
762
|
|
|
764
|
-
## Parameterized themes — Monochrome & Adaptive
|
|
763
|
+
## Parameterized themes — Monochrome & Adaptive
|
|
765
764
|
|
|
766
765
|
Two themes generate their palette from colors you pass in (OKLCH-based, so the result stays perceptually balanced). Because a theme cannot take constructor parameters, these ship as **factory functions** — call them with `(root, settings)`; `.new(root, settings)` also works.
|
|
767
766
|
|
|
@@ -796,7 +795,7 @@ root.setThemes([
|
|
|
796
795
|
|
|
797
796
|
Both are additive (they do not modify built-in themes) and both handle dark mode themselves via `dark: true` — do not also add the `Dark` theme.
|
|
798
797
|
|
|
799
|
-
**More settings (
|
|
798
|
+
**More settings (both themes, all off by default):** `interleave: true` takes the colors in the order 1, 4, 2, 5, 3, 6, so series next to each other differ more (Monochrome keeps `accent` first); `mapShade: true` fills map land with a mid shade of the base color, as light as default map land, instead of the color itself; `keepContrast: true` keeps the series colors and primary buttons at least 3:1 against the background (or give a ratio, e.g. `4.5`). In Adaptive it moves `baseColor` and `baseColor2` themselves, so the first color is then not exactly the brand color; in Monochrome it moves the end of the shades nearest the background. A branded palette:
|
|
800
799
|
|
|
801
800
|
```js
|
|
802
801
|
am5themes_Adaptive(root, { baseColor: 0x2c6e91, baseColor2: 0xffdd00, count: 10, interleave: true, mapShade: true, keepContrast: true })
|
|
@@ -858,11 +857,11 @@ colors.set("colors", [
|
|
|
858
857
|
]);
|
|
859
858
|
```
|
|
860
859
|
|
|
861
|
-
**Swapping a `ColorSet`.** The theme's `baseColor` resolves lazily, so a **synchronous** re-color right after swapping a `ColorSet` can read a transient value (sprites momentarily black). Re-set the series data and let amCharts' own data pass recolor the sprites.
|
|
860
|
+
**Swapping a `ColorSet`.** The theme's `baseColor` resolves lazily, so a **synchronous** re-color right after swapping a `ColorSet` can read a transient value (sprites momentarily black). Re-set the series data and let amCharts' own data pass recolor the sprites. An empty `colors` list starts from `baseColor`.
|
|
862
861
|
|
|
863
|
-
**`step` with a theme that reuses its colors** (`reuse: true`: Adaptive, Monochrome, Nord, Pastel, Kelly, …):
|
|
862
|
+
**`step` with a theme that reuses its colors** (`reuse: true`: Adaptive, Monochrome, Nord, Pastel, Kelly, …): every color is used before any repeats, so `step: count / 2` interleaves the palette.
|
|
864
863
|
|
|
865
|
-
**Repeats are lighter
|
|
864
|
+
**Repeats are lighter.** In themes that reuse their list, once every color has been used, the next round is 10% lighter. This covers Adaptive, Monochrome, Ember, Frozen, Kelly, Material, Midnight, Moonrise, Nord, Pastel, Petroleum, Savanna and Spirited, with their Dark variants, but not Colorblind, Patterns or Dataviz. The setting is `repeatLightness` on the `ColorSet`: HSL lightness per round, `0.1` is 10%, and a negative value makes it darker. It only acts with `reuse: true`. The color sets of one root share the theme's list, and the repeats are added to that list, so whichever color set on the root first needs a new round decides that round for every chart on it. To repeat the colors as they are, set it for the whole root:
|
|
866
865
|
|
|
867
866
|
```js
|
|
868
867
|
// Every ColorSet on the root, through a theme rule
|
|
@@ -876,7 +875,7 @@ am5themes_Adaptive.new(root, { repeatLightness: false });
|
|
|
876
875
|
|
|
877
876
|
With one chart on the root, `chart.get("colors").set("repeatLightness", 0)` before the data is set works too.
|
|
878
877
|
|
|
879
|
-
**Three or more series.** Smallest color difference (CIEDE2000) among the first 4 / 6 series colors
|
|
878
|
+
**Three or more series.** Smallest color difference (CIEDE2000) among the first 4 / 6 series colors; higher is easier to tell apart:
|
|
880
879
|
|
|
881
880
|
| Choice | First 4 / 6 | Note |
|
|
882
881
|
|---|---|---|
|
|
@@ -897,12 +896,14 @@ series.data.processor = am5.DataProcessor.new(root, {
|
|
|
897
896
|
dateFormat: "yyyy-MM-dd", // read as local time (UTC with root.utc); see below for leaving it out
|
|
898
897
|
numericFields: ["value", "count"],
|
|
899
898
|
colorFields: ["color"],
|
|
900
|
-
emptyAs: 0 // replace null, undefined and "" with 0 (
|
|
899
|
+
emptyAs: 0 // replace null, undefined and "" with 0 (0 and false stay)
|
|
901
900
|
});
|
|
902
901
|
// Configure processor BEFORE setting data
|
|
903
902
|
```
|
|
904
903
|
|
|
905
|
-
Without `dateFormat`,
|
|
904
|
+
Without `dateFormat`, the browser's `Date` parses the strings, so ISO strings work and a date-only `"2024-03-15"` is midnight **UTC**.
|
|
905
|
+
|
|
906
|
+
**CSV:** `am5.CSVParser.parse(text, options)` turns CSV text into rows. An empty string gives `[]` with `useColumnNames: true`, but `[{}]` (one empty row) with the default options, so check for that before `data.setAll()`. Empty lines are skipped unless `skipEmpty: false`.
|
|
906
907
|
|
|
907
908
|
## Serializing to JSON (ChartSerializer / JsonParser)
|
|
908
909
|
|
|
@@ -910,18 +911,18 @@ Without `dateFormat`, since 5.21.1 the browser's `Date` parses the strings, so I
|
|
|
910
911
|
|
|
911
912
|
`am5plugins_json.ChartSerializer` turns a live chart into a JSON config and `am5plugins_json.JsonParser` rebuilds it (`await parser.parse(config, { parent: root.container })`). Rules that keep round-trips working:
|
|
912
913
|
|
|
913
|
-
- **Serialize the chart's top-level container child:** `serializer.serializeAll(root.container.children.getIndex(0))` — the chart, or on chart-less types (hierarchy, flow, word cloud, Venn) the series itself.
|
|
914
|
-
- **Adapters do not round-trip.** `includeAdapters` (default `true`) writes each adapter as `{ key, callback: "function (…) {…}" }`; the parser does not turn that string back into a function (and the closure's `chart`/`series`/`root` would not exist anyway).
|
|
915
|
-
- **Only user-set settings are serialized
|
|
916
|
-
- **Re-parsing into an existing chart:** `parser.parse(config, { updateTargets: "soft" })`
|
|
917
|
-
- **Maps and locales with npm imports
|
|
918
|
-
- **Also saved
|
|
919
|
-
- **Data-item loops
|
|
920
|
-
- **Also saved
|
|
921
|
-
- **Not captured by `ChartSerializer
|
|
914
|
+
- **Serialize the chart's top-level container child:** `serializer.serializeAll(root.container.children.getIndex(0))` — the chart, or on chart-less types (hierarchy, flow, word cloud, Venn) the series itself. A series placed straight in `root.container`, or one whose `selectedDataItem` points back at itself, serializes too. A drilled-down hierarchy's `selectedDataItem` is not restored (it is written as `"@self.dataItems.-1"`).
|
|
915
|
+
- **Adapters do not round-trip.** `includeAdapters` (default `true`) writes each adapter as `{ key, callback: "function (…) {…}" }`; the parser does not turn that string back into a function (and the closure's `chart`/`series`/`root` would not exist anyway). On parse such adapters are skipped, so the effect is lost — replace palette-coloring adapters with declarative equivalents: `colorByDataItem: true` on column series, a per-item `fill` data field + `templateField`, or `heatRules`.
|
|
916
|
+
- **Only user-set settings are serialized** — theme and library defaults are left out, so a value you never set will not appear in it. Add `includeRoot: true` to also write a top-level `root` section (Root settings/properties, `interfaceColors`, formatters). A parsed `root` section sets only those properties and a named locale, and never turns `sanitizeHTML` off, unless parsed with `trusted: true` (`references/json.md` rule 9).
|
|
917
|
+
- **Re-parsing into an existing chart:** `parser.parse(config, { updateTargets: "soft" })` applies settings onto an existing object of the same `type` instead of replacing it. The default `"strict"` replaces.
|
|
918
|
+
- **Maps and locales with npm imports:** a geodata pack or locale that isn't a global is copied into the config whole, about 250 KB for `worldLow`, unless the serializer gets it in `resources`. `am5plugins_json.ChartSerializer.new(root, { resources: { am5geodata_worldLow } })` writes `"geoJSON": "am5geodata_worldLow"` instead; parse it back with the same `resources` (`references/json.md`, rule 8). With script tags the packs are globals and are written by name without it.
|
|
919
|
+
- **Also saved:** `themeTags` you pass to `.new()` (e.g. a `Button` with `themeTags: ["switch"]` keeps its look; tags the library adds are left out); a legend inside an `axisHeader`; declared `animations` (see "Animations"); and animations started in code that **loop forever** (`loops: Infinity`) with a nameable `am5.ease` easing — written as `animations` entries. `runningAnimations` (default `true`) controls the latter: `am5plugins_json.ChartSerializer.new(root, { runningAnimations: false })` turns it off. Never saved: finite animations (`appear()`, states, zoom) and loops with a custom-function or `pow` easing — for the opening animation use `autoAppear` (see "Animations").
|
|
920
|
+
- **Data-item loops:** a loop started on a **data item** in code (`dataItem.animate({ key: "positionOnLine", loops: Infinity, … })`) is saved as an `animations` entry with `target: "dataItem"`. When every data item plays the same loop, it goes on the bullet sprite. When they differ (e.g. points each moving at their own speed), each one goes in its own data row, under the sprite's `templateField` (`"bulletSettings"` if none is set).
|
|
921
|
+
- **Also saved:** a series hidden with `hide()` or a legend click; elements you add to library-built containers (`chart.plotContainer`, `seriesContainer`, axes containers, an axis) — no `themeTags: ["serialize"]` needed; a `ZoomableContainer`'s `contents`; `Date` values (as timestamps); settings on a series' `bulletsContainer` and on a pie/funnel series' `labelsContainer`/`ticksContainer`; the `axisFills`, `rectangles` (`Treemap`, `Partition`) and `polygons` (`VoronoiTreemap`) templates. A color taken from `root.interfaceColors` is written as a reference, `"@root.interfaceColors.get('background')"`, so a config parsed under another theme (e.g. Dark) uses that theme's color — write the same string in hand-made configs. A color taken from the theme's palette with `getIndex()` is written as `"@colors.getIndex(3)"` the same way, and hand-made configs can use it too in settings (e.g. `"fill": "@colors.getIndex(0)"`). Colors a color set makes past the theme's list are written as references too. In a data row (e.g. a column `fill` from a `templateField`) the serializer marks the row, and the object in it that holds the reference, with `"__parse": true`; the parser reads references only in marked objects (and in arrays), and elsewhere in data a string starting with `@` or `#` is plain text. A hand-written data row needs both markers: `{ "c": "A", "v": 10, "cs": { "fill": "@colors.getIndex(2)", "__parse": true }, "__parse": true }` (see `references/json.md`, rule 3). A setting such as `step` on a chart's colors is written without the theme's palette.
|
|
922
|
+
- **Not captured by `ChartSerializer`** — re-apply these in code after `parse()`: a `ZoomTools` you added to a hand-made `ZoomableContainer` (its `target` is written as a copy, so the parsed buttons drive a different container — re-point `target`, or use `am5.SerialChartContainer`, which wires its own `zoomTools`); Venn `hoverGraphics` (Venn slice-template `states` do round-trip); data items added with `pushDataItem()` (only `series.data` rows are written — map points on lines can be data rows, see `references/map.md`).
|
|
922
923
|
- **Bullets** are captured by calling the factory with a sample data item — write factories as `function(root, series, dataItem)` (pitfall #36).
|
|
923
924
|
|
|
924
|
-
**`<am5-chart>` — a chart as an HTML element
|
|
925
|
+
**`<am5-chart>` — a chart as an HTML element.** Builds a chart from a JSON config with no root or chart code. With script tags, load `index.js`, `plugins/json.js`, `element.js`, then every chart package the config uses; with npm, `import { defineChartElement } from "@amcharts/amcharts5/element"` and call `defineChartElement()`, which does nothing if the element already exists. A bare `import "@amcharts/amcharts5/element"` also works. Chart packages are loaded on demand. Then set `element.themes = [am5themes_Animated, am5themes_ResponsiveMax]`, for a map `element.resources = { am5geodata_worldLow }`, and `element.config = {…}`, as properties:
|
|
925
926
|
|
|
926
927
|
```html
|
|
927
928
|
<script src="https://cdn.amcharts.com/lib/5/index.js"></script>
|
|
@@ -945,7 +946,7 @@ document.querySelector("am5-chart").whenReady().then(function (r) {
|
|
|
945
946
|
</script>
|
|
946
947
|
```
|
|
947
948
|
|
|
948
|
-
Attributes: `config` (JSON) or `src` (URL of a JSON file), `themes`, `renderer="svg"` (default canvas). The `themes` attribute takes names, space- or comma-separated, or
|
|
949
|
+
Attributes: `config` (JSON) or `src` (URL of a JSON file), `themes`, `renderer="svg"` (default canvas). The `themes` attribute takes names, space- or comma-separated, or JSON with a theme's settings: `themes='["Animated", "ResponsiveMax", ["Adaptive", { "baseColor": "#4150a0" }]]'`. It works with script tags only. With npm, the `themes` property takes theme classes, e.g. `[am5themes_Animated, am5themes_ResponsiveMax]`, or a class with its settings: `[am5themes_Animated, am5themes_ResponsiveMax, [am5themes_Adaptive, { baseColor: "#4150a0" }]]`. Without a height from CSS or its parent it is 400 px high. Themes are not part of a config. Changing `config`/`themes` rebuilds the chart; removing the element disposes it.
|
|
949
950
|
|
|
950
951
|
## Accessibility
|
|
951
952
|
|
|
@@ -959,9 +960,9 @@ series.columns.template.setAll({
|
|
|
959
960
|
// focusableGroup: "series1" — TAB to first, arrows within group
|
|
960
961
|
```
|
|
961
962
|
|
|
962
|
-
**High contrast
|
|
963
|
+
**High contrast:** in a forced-colors mode such as Windows High Contrast, labels, grid, axes and buttons take the system colors so they stay visible; series colors are kept. It is on by default — `am5.Root.new("chartdiv", { forcedColors: false })` keeps the chart's own interface colors.
|
|
963
964
|
|
|
964
|
-
Keyboard/screen-reader behavior
|
|
965
|
+
Keyboard/screen-reader behavior: a `focusableGroup` is one TAB stop; arrow keys move between its members even when they are draggable (flow and hierarchy nodes) and SHIFT + arrows drag them; ESC hides a focused element's tooltip and ends a keyboard drag; SPACE clicks a focused element with a button-like `role`. The `ariaExpanded` setting is set by the library on Gantt tasks with subtasks and on hierarchy nodes with children; a `role: "button"` with `toggleKey` exposes `aria-pressed`. `am5.Modal` is a dialog to screen readers, named by its `ariaLabel` setting (else its first heading).
|
|
965
966
|
|
|
966
967
|
## Container & Layout
|
|
967
968
|
|
|
@@ -993,7 +994,9 @@ container.setAll({
|
|
|
993
994
|
|
|
994
995
|
Use layouts to arrange charts, legends, controls, and labels within containers.
|
|
995
996
|
|
|
996
|
-
**
|
|
997
|
+
**Hidden children take no space.** An element hidden with `visible: false`, `forceHidden` or `hide()` takes up no room in a container sized to its content, e.g. a hidden XY scrollbar leaves no empty band above the plot.
|
|
998
|
+
|
|
999
|
+
**Right to left: `direction: "rtl"`.** On a container with a horizontal or grid layout, it places the children from right to left, as a mirror image: a child's `marginLeft` ends up on its right. Rows of a grid still go top to bottom. In a vertical layout, children with no `x` of their own line up on the right. For a right-to-left language, set the Root's `direction` instead, which also turns the text and lays out the legends (see "Legend"). `reverseChildren: true` only reverses the order, so a grid starts at the bottom row; don't use it for RTL.
|
|
997
1000
|
|
|
998
1001
|
## UI Elements
|
|
999
1002
|
|
|
@@ -1040,7 +1043,7 @@ button.events.on("click", function() {
|
|
|
1040
1043
|
|
|
1041
1044
|
## Frameworks (React, Vue, Angular, Svelte, React Native)
|
|
1042
1045
|
|
|
1043
|
-
In a framework app, use amCharts' package for that framework instead of writing the mount and dispose code yourself. The
|
|
1046
|
+
In a framework app, use amCharts' package for that framework instead of writing the mount and dispose code yourself. The current ones are react 5.0.1, vue 5.0.2, angular 5.0.1, svelte 5.0.3 and react-native 5.0.3, which loads amCharts 5.22.0. Each package makes the chart once its element is on the page, disposes it with the component, and loads the library in the browser only, so pages rendered on a server work (Next.js, Nuxt, SvelteKit, Angular SSR). Each takes a chart written in code, or a chart from a JSON config (it wraps the `<am5-chart>` element, see "Serializing to JSON").
|
|
1044
1047
|
|
|
1045
1048
|
| Framework | Package | A chart in code | A chart from a JSON config |
|
|
1046
1049
|
|---|---|---|---|
|
|
@@ -1050,7 +1053,7 @@ In a framework app, use amCharts' package for that framework instead of writing
|
|
|
1050
1053
|
| Svelte 4+ (SvelteKit) | `@amcharts/amcharts5-svelte` | Svelte 5.29+: `<div {@attach attachAmChart(buildChart)} style="height: 500px">`; Svelte 4 and older 5: `<div use:amChart={{ setup: buildChart, deps: [data] }}>` | `<am5-chart {@attach attachAmChartConfig({ config, themes })}>`, or `use:amChartConfig={{ config, themes }}`; events `onready`/`onerror` (`on:ready` in Svelte 4) |
|
|
1051
1054
|
| React Native 0.72+ | `@amcharts/amcharts5-react-native` (+ `react-native-webview` 13+) | `<AmChart code={code} data={data} />`, where `code` is a **string** (below) | `<AmChart config={config} themes={["Animated", "ResponsiveMax"]} />` |
|
|
1052
1055
|
|
|
1053
|
-
Install the library with the package: `npm install @amcharts/amcharts5 @amcharts/amcharts5-react`. The current web packages need amCharts 5.21.4 or later (peer dependency `^5.21.4`)
|
|
1056
|
+
Install the library with the package: `npm install @amcharts/amcharts5 @amcharts/amcharts5-react`. The current web packages need amCharts 5.21.4 or later (peer dependency `^5.21.4`). React Native installs only `@amcharts/amcharts5-react-native react-native-webview`: the WebView loads the library from the amCharts CDN.
|
|
1054
1057
|
|
|
1055
1058
|
```jsx
|
|
1056
1059
|
// React. Vue, Angular and Svelte work the same way: your function gets the root.
|
|
@@ -1093,8 +1096,8 @@ function Chart({ data }) {
|
|
|
1093
1096
|
- **The chart's element needs a height.** The JSON-config components are 400 px high without one.
|
|
1094
1097
|
- **Deps make the chart again from scratch:** `[data]` in React, `watch` in Vue (what Vue's `watch()` takes; add `deep: true` to also catch `push()`), `[amChartDeps]` in Angular, `deps` in Svelte actions. A Svelte attachment runs again when state read in its own expression changes. To change data without rebuilding, return what you need and use it from `result` (React, Vue), from `(amChartReady)`'s `{ root, result }` (Angular), or from a `$state.raw` variable set in the function (Svelte).
|
|
1095
1098
|
- **SVG:** `useAmChart(setup, deps, { renderer: "svg" })` in React, `{ renderer: "svg" }` in Vue's options, `[amChartRenderer]="'svg'"` in Angular, and `attachAmChart(setup, { renderer: "svg" })` or `renderer: "svg"` in Svelte's action parameter. The JSON-config components take a `renderer` prop or input.
|
|
1096
|
-
- **Themes for the JSON-config components are classes** (`[am5themes_Animated, am5themes_ResponsiveMax]`, not `.new(root)`): themes are not part of a config. A theme with its settings is a pair
|
|
1097
|
-
- **Maps and locales in a JSON config
|
|
1099
|
+
- **Themes for the JSON-config components are classes** (`[am5themes_Animated, am5themes_ResponsiveMax]`, not `.new(root)`): themes are not part of a config. A theme with its settings is a pair: `[am5themes_Animated, am5themes_ResponsiveMax, [am5themes_Adaptive, { baseColor: "#4150a0" }]]`. React Native takes theme **names** (`["Animated", "ResponsiveMax", "Dark"]`), and the pair as `["Adaptive", { baseColor: "#4150a0" }]`.
|
|
1100
|
+
- **Maps and locales in a JSON config**: the config names its geodata (`"geoJSON": "am5geodata_worldLow"`) and locale (`"am5locales_de_DE"`), and with npm imports those aren't globals, so pass them in the `resources` prop: `<AmChart config={config} resources={{ am5geodata_worldLow }} />` in React (import it from `@amcharts/amcharts5-geodata/worldLow`), `:resources` in Vue, `[resources]` in Angular, and `resources` in Svelte's `attachAmChartConfig({ config, resources })` / `use:amChartConfig`. Without it the map is blank, with a console warning that names the pack. React Native loads the geodata a config names by itself, but not a locale: give it `modules={["locales/de_DE"]}`.
|
|
1098
1101
|
- **Give amCharts plain data.** In Vue, keep amCharts objects out of reactive state: use `shallowRef()` for data, or pass `toRaw(data)`. In Svelte 5, use `$state.snapshot(data)`.
|
|
1099
1102
|
- **License:** call `am5.addLicense("AM5C-…")` once when the app starts, before any chart is made, never in the setup function, because the logo is decided when the root is made. Put it in `main.ts`/`main.jsx`, before `createApp()` or `bootstrapApplication()`. In Next.js, put it at the top of a client component's file; in Nuxt, in a client plugin (`plugins/amcharts.client.ts`); in SvelteKit, in `src/hooks.client.ts`. React Native takes `licenses={["AM5C-…"]}` on each chart.
|
|
1100
1103
|
- **Errors** thrown in your function go to React's nearest error boundary, Vue's `app.config.errorHandler`, Angular's `ErrorHandler` and `(amChartError)`, and Svelte's `onError` option (an uncaught error without it).
|
|
@@ -1174,13 +1177,13 @@ onMount(() => { const root = am5.Root.new(chartdiv); /* ... */ return () => root
|
|
|
1174
1177
|
6. **Raw hex strings for colors** — use `am5.color()`.
|
|
1175
1178
|
7. **Mixing v4 and v5 API** — they are completely incompatible.
|
|
1176
1179
|
8. **Calling `chart.dispose()` instead of `root.dispose()`** — always dispose root.
|
|
1177
|
-
9. **Using CSS to style chart elements** — amCharts draws on canvas by default; even with `am5.SVGRenderer`
|
|
1180
|
+
9. **Using CSS to style chart elements** — amCharts draws on canvas by default; even with `am5.SVGRenderer` its shapes have no per-element classes, are rewritten on redraw, and exports ignore page CSS. Style through settings, templates and themes.
|
|
1178
1181
|
10. **Wrong package import** — check the package map table above.
|
|
1179
1182
|
11. **Calling `.each()` on `dataItems`** — `series.dataItems` is a plain array, not an amCharts `List`. Use `am5.array.each(series.dataItems, fn)` or standard `forEach`/`for` loops. Only `series.data` (the `ListData` object) has `.each()`.
|
|
1180
|
-
12. **CDN script load order** — `index.js` must load first, then `xy.js`, then any package that depends on it (`radar.js`, `timeline.js`, `gantt.js`). Wrong order causes runtime errors. Correct order: `index.js`, `xy.js`, then `radar.js` / `timeline.js` / `gantt.js`, then `themes/*.js`. Gantt also needs `plugins/colorPicker.js` before `gantt.js`, or `am5gantt` is undefined. From an npm CDN
|
|
1183
|
+
12. **CDN script load order** — `index.js` must load first, then `xy.js`, then any package that depends on it (`radar.js`, `timeline.js`, `gantt.js`). Wrong order causes runtime errors. Correct order: `index.js`, `xy.js`, then `radar.js` / `timeline.js` / `gantt.js`, then `themes/*.js`. Gantt also needs `plugins/colorPicker.js` before `gantt.js`, or `am5gantt` is undefined. From an npm CDN the order and file names are the same under `…/@amcharts/amcharts5@<version>/dist/`; load every file from one pinned version.
|
|
1181
1184
|
13. **No `minorGrid` / `minorTicks` / `minorLabels` objects** — These do not exist on axes. Minor grid is enabled via boolean flags on the **renderer**: `minorGridEnabled: true` and optionally `minorLabelsEnabled: true`. Styling is done through theme rules targeting the `"minor"` tag, not through separate object properties.
|
|
1182
1185
|
14. **Flow chart animated bullets go on `series.bullets`, NOT `series.links.template.bullets`** — To animate labels/circles flowing along Sankey or Chord links, use `series.bullets.push(function(...) { ... })`. Animate `bullet.locationX` (Sankey) or `bullet.locationY` (Chord) from 0→1 with `loops: Infinity`. Use an adapter on opacity for fade effect. See `references/flow.md` → "Animated bullets along links".
|
|
1183
|
-
15. **`MapPointSeries` needs `latitudeField`/`longitudeField` when your data fields are named anything other than `latitude`/`longitude`** —
|
|
1186
|
+
15. **`MapPointSeries` needs `latitudeField`/`longitudeField` when your data fields are named anything other than `latitude`/`longitude`** — The series defaults to `latitudeField: "latitude"`, `longitudeField: "longitude"`, so data using exactly those names works with no declaration. Any other naming (`lat`/`lng`, `y`/`x`, …) must be declared or the points silently won't appear: `am5map.MapPointSeries.new(root, { latitudeField: "lat", longitudeField: "lng" })`. Neither is needed with `pushDataItem({ latitude: ..., longitude: ... })`, which passes coordinates directly.
|
|
1184
1187
|
16. **`data.setAll()` does NOT animate — use `data.setIndex()` for animated updates** — When the user asks to update/refresh data with animation, do NOT use `series.data.setAll(newData)` — it replaces everything instantly with no transition. Instead, update each item with `series.data.setIndex(i, newItem)` which triggers smooth value animation. For full replacement with animation, loop: `newData.forEach(function(item, i) { series.data.setIndex(i, item); })`.
|
|
1185
1188
|
17. **`color.lighten()` / `color.darken()` are NOT instance methods** — `am5.color(0xff0000).lighten(0.3)` does NOT work. Use static methods: `am5.Color.lighten(color, 0.3)` to lighten, `am5.Color.lighten(color, -0.3)` to darken. There is NO `darken()` method — use negative lighten. Also available: `am5.Color.brighten()`, `am5.Color.saturate()`.
|
|
1186
1189
|
18. **Venn diagram has no `VennDiagram` class** — `am5venn.Venn` is pushed directly into a `Container`, NOT into a chart's `series`. See `references/venn.md`.
|
|
@@ -1206,9 +1209,9 @@ onMount(() => { const root = am5.Root.new(chartdiv); /* ... */ return () => root
|
|
|
1206
1209
|
38. **Changing a value on a data item moves nothing** — series draw from the working values: set `valueYWorking` (XY) or `valueWorking` (pie) along with the value, or use `series.data.setIndex()`. See "Dynamic data".
|
|
1207
1210
|
39. **A setting changed after a hover snaps back on unhover** — the `"default"` state keeps the value from before the first hover. Change it there too: `sprite.states.lookup("default")?.set("fill", c)`. See "States".
|
|
1208
1211
|
40. **`templateField` goes on the template, not on the series** — per-item settings from data rows are read by the elements a template makes: `series.columns.template.set("templateField", "columnSettings")`, likewise `slices.template`, `mapPolygons.template` or a bullet sprite. Set on the series, `templateField` does nothing and every column stays the same. For a pattern per column, see `references/xy.md` → "Different pattern per column".
|
|
1209
|
-
41. **A JSON-config map that draws nothing with npm imports** — the config names its geodata (`"geoJSON": "am5geodata_worldLow"`), and with npm imports there is no global of that name. Pass the pack in `resources
|
|
1212
|
+
41. **A JSON-config map that draws nothing with npm imports** — the config names its geodata (`"geoJSON": "am5geodata_worldLow"`), and with npm imports there is no global of that name. Pass the pack in `resources`: `JsonParser.parse(config, { parent, resources: { am5geodata_worldLow } })`, `element.resources`, or the framework packages' `resources` prop. The same goes for a locale (`am5locales_de_DE`). A console warning names the missing pack. A config serialized from such a chart copies the whole pack unless `ChartSerializer` gets the same `resources`.
|
|
1210
1213
|
42. **An `am5.Graphics` redraws only when `draw` changes** — `graphics.set("draw", fn)` with the function it already has does nothing. Pass a new closure that captures the new points: `graphics.set("draw", (display) => paint(display, points))`.
|
|
1211
|
-
43. **A legend value without a cursor needs `calculateAggregates`** — `legendValueText` is used only under a cursor; otherwise the value label shows `legendRangeValueText`, which has no data item: `{valueY}` is empty there, and `{valueYClose}` (the latest value), `{valueYSum}`, `{valueYHigh}` and the other range values are empty unless the series has `calculateAggregates: true` (no warning
|
|
1214
|
+
43. **A legend value without a cursor needs `calculateAggregates`** — `legendValueText` is used only under a cursor; otherwise the value label shows `legendRangeValueText`, which has no data item: `{valueY}` is empty there, and `{valueYClose}` (the latest value), `{valueYSum}`, `{valueYHigh}` and the other range values are empty unless the series has `calculateAggregates: true` (no warning). See `references/xy.md` → Legend.
|
|
1212
1215
|
44. **`#,###` does not round** — a number format without a `.` keeps every decimal (`6,708.044000000005` while animating); end it with `.` for whole numbers (`'#,###.'`) or give the decimals (`'#,###.00'`). Every number placeholder also gets a thousands separator, so `{year}` shows `2,024`: use `{year.formatNumber('#')}`. Sections are split by `|`, not `;`. See "Number formats".
|
|
1213
1216
|
|
|
1214
1217
|
## Easing functions
|
|
@@ -1235,7 +1238,7 @@ sprite.animate({
|
|
|
1235
1238
|
easing: am5.ease.out(am5.ease.cubic)
|
|
1236
1239
|
});
|
|
1237
1240
|
|
|
1238
|
-
// Name <-> function
|
|
1241
|
+
// Name <-> function
|
|
1239
1242
|
am5.ease.byName("cubic", "out"); // same as am5.ease.out(am5.ease.cubic); unknown name -> linear
|
|
1240
1243
|
am5.ease.easingInfo(am5.ease.yoyo(am5.ease.sine)); // { easing: "sine", yoyo: true }
|
|
1241
1244
|
```
|
|
@@ -1254,24 +1257,24 @@ Skip this step entirely if you cannot execute code (e.g., chat-only context with
|
|
|
1254
1257
|
|
|
1255
1258
|
## Recent API changes
|
|
1256
1259
|
|
|
1257
|
-
Latest release covered here: **5.22.0** (2026-11-16), with geodata 5.2.0, and the framework packages react 5.0.1, vue 5.0.2, angular 5.0.1, svelte 5.0.3
|
|
1260
|
+
Latest release covered here: **5.22.0** (2026-11-16), with geodata 5.2.0, and the framework packages react 5.0.1, vue 5.0.2, angular 5.0.1, svelte 5.0.3 and react-native 5.0.3. These are the renames, new settings and behaviors that code written from older knowledge most often gets wrong — prefer these names/settings. For exact types and defaults, use the typings (`*.d.ts`) or the amCharts MCP server's `get_api_reference`, which is generated from them; for anything newer, verify against the live docs (see next section).
|
|
1258
1261
|
|
|
1259
1262
|
**Renamed settings (old name still works but is deprecated — use the new one):**
|
|
1260
1263
|
|
|
1261
|
-
| Class(es) | Old | New |
|
|
1262
|
-
|
|
1263
|
-
| `MovingAverage`, `MovingAverageDeviation`, `MovingAverageEnvelope`, `BollingerBands` | `type` | `maType` |
|
|
1264
|
-
| `VoronoiTreemap` | `type` | `shapeType` |
|
|
1264
|
+
| Class(es) | Old | New |
|
|
1265
|
+
|-----------|-----|-----|
|
|
1266
|
+
| `MovingAverage`, `MovingAverageDeviation`, `MovingAverageEnvelope`, `BollingerBands` | `type` | `maType` |
|
|
1267
|
+
| `VoronoiTreemap` | `type` | `shapeType` |
|
|
1265
1268
|
|
|
1266
1269
|
```js
|
|
1267
1270
|
// Moving-average indicators: use maType, not type
|
|
1268
1271
|
am5stock.MovingAverage.new(root, { maType: "exponential", period: 20 });
|
|
1269
|
-
am5hierarchy.VoronoiTreemap.new(root, { shapeType: "rectangle" }); //
|
|
1272
|
+
am5hierarchy.VoronoiTreemap.new(root, { shapeType: "rectangle" }); // not type
|
|
1270
1273
|
```
|
|
1271
1274
|
|
|
1272
|
-
**
|
|
1275
|
+
**WordCloud labels:** the layout is computed synchronously in one pass. There is no per-data-item `ghostLabel`, and labels live in an internal container, so reach them with `series.labels` / `dataItem.get("label")`, not by walking `series.children`.
|
|
1273
1276
|
|
|
1274
|
-
**Framework packages
|
|
1277
|
+
**Framework packages:** `@amcharts/amcharts5-react`, `@amcharts/amcharts5-vue`, `@amcharts/amcharts5-angular`, `@amcharts/amcharts5-svelte` and `@amcharts/amcharts5-react-native`. They make and dispose the chart with the component and work with server rendering. Prefer them over hand-written `Root.new()`/`dispose()` code in those frameworks. See "Frameworks".
|
|
1275
1278
|
|
|
1276
1279
|
**New in 5.22.0 (2026-11-16):**
|
|
1277
1280
|
- **Script files on npm CDNs:** the npm package has the script files in `dist/`, so jsDelivr and unpkg serve them (see "Plain HTML, no bundler"). Geodata 5.2.0 has `dist/` too, on unpkg.
|
|
@@ -1281,198 +1284,92 @@ am5hierarchy.VoronoiTreemap.new(root, { shapeType: "rectangle" }); // was: type
|
|
|
1281
1284
|
- Bounds with `right` less than `left`, or past ±180, cross the date line. On a flat map the two sides meet only with a rotation passed, e.g. `zoomToGeoBounds(bounds, 500, -180)`.
|
|
1282
1285
|
- A `zoomToGeoBounds()`, `zoomToDataItem()` or `zoomToGeoPoint()` call before the map is drawn zooms once it is.
|
|
1283
1286
|
- Zooms keep `rotationZ`.
|
|
1284
|
-
- Two `zoomToGeoPoint()` or `zoomToPoint()` calls in a row without animation end in the right place.
|
|
1285
1287
|
- **Maps, data:**
|
|
1286
|
-
- GeoJSON feature properties are read as data fields: with `valueField: "value"` set, a custom GeoJSON with `"properties": { "value": 12 }` gives each polygon its value without data rows, and heat rules their range.
|
|
1287
|
-
- A series with heat rules whose `geoJSON` is set later (a drill-down) draws.
|
|
1288
|
+
- GeoJSON feature properties are read as data fields: with `valueField: "value"` set, a custom GeoJSON with `"properties": { "value": 12 }` gives each polygon its value without data rows, and heat rules their range.
|
|
1288
1289
|
- When `include` and `exclude` both list an item, `exclude` wins.
|
|
1289
|
-
-
|
|
1290
|
-
|
|
1291
|
-
- **Heat rules:** values outside `minValue` / `maxValue` get `min` / `max` instead of going past the ends. On a `logarithmic` rule, zero and below get `min`.
|
|
1290
|
+
- A map with panning and `pinchZoom` off lets the page scroll on touch screens.
|
|
1291
|
+
- **Heat rules:** values outside `minValue` / `maxValue` get `min` / `max`. On a `logarithmic` rule, zero and below get `min`.
|
|
1292
1292
|
- **Number formats:** a modifier right after the digits, as in `#,###s`, keeps the thousands separator.
|
|
1293
|
-
- **ValueAxis:** a `logarithmic` axis with `min: 0` starts at `treatZeroAs`, or where the data starts
|
|
1294
|
-
- **
|
|
1295
|
-
|
|
1296
|
-
|
|
1297
|
-
- A `PicturePattern` the size of its picture shows it.
|
|
1298
|
-
- `drawEllipse(x, y, …)` draws at x, y.
|
|
1299
|
-
- **Series and bullets:**
|
|
1300
|
-
- Bullets that take the series color follow it when it changes.
|
|
1301
|
-
- Setting `minBulletDistance` back to 0 shows the bullets again.
|
|
1302
|
-
- `data.setIndex()` and `updateData()` apply the row's `templateField` settings.
|
|
1303
|
-
- **Pie labels:** a label hidden with `forceHidden` no longer leaves a gap in its column. `PyramidSeries` and `PictorialStackedSeries` with `alignLabels: false` keep their labels on their slices.
|
|
1304
|
-
- **Gantt:** charts with many tasks load several times faster and scroll two to three times as fast. The date rows' labels use `keepInView`, and on a narrow chart a view of two to four weeks shows months in the top row instead of labels on top of each other.
|
|
1305
|
-
- **Hierarchy:** after `data.setAll()`, a `VoronoiTreemap` draws again, and a drilled-down Treemap or Sunburst shows the new data from the top.
|
|
1306
|
-
- **Word cloud:** a number as a category (a year) no longer throws, but shows formatted, `2,025`. See `references/wordcloud.md`.
|
|
1293
|
+
- **ValueAxis:** a `logarithmic` axis with `min: 0` starts at `treatZeroAs`, or where the data starts.
|
|
1294
|
+
- **Gantt:** the date rows' labels use `keepInView`, and on a narrow chart a view of two to four weeks shows months in the top row.
|
|
1295
|
+
- **Hierarchy:** after `data.setAll()`, a drilled-down Treemap or Sunburst shows the new data from the top.
|
|
1296
|
+
- **Word cloud:** a number as a category (a year) shows formatted, `2,025`, so pass years as strings. See `references/wordcloud.md`.
|
|
1307
1297
|
- **Right to left:**
|
|
1308
1298
|
- `am5.Root.new("chartdiv", { direction: "rtl" })` draws text right to left and lays out legends from the right. See "Legend".
|
|
1309
1299
|
- Containers take `direction: "rtl"`, which lays out a horizontal or grid layout from right to left and lines a vertical layout's children up on the right.
|
|
1310
|
-
- On a `dir="rtl"` page, labels are placed
|
|
1300
|
+
- On a `dir="rtl"` page, labels are placed and drawn right to left.
|
|
1311
1301
|
- A `Label` with a `width` keeps its text inside its box for every `textAlign` and `direction`.
|
|
1312
|
-
- **Text:** font names with spaces, and font lists such as `[fontFamily: 'Source Code Pro', monospace]`,
|
|
1302
|
+
- **Text:** font names with spaces, and font lists such as `[fontFamily: 'Source Code Pro', monospace]`, work in text markup.
|
|
1313
1303
|
- **TypeScript:** `am5.IGraphics` and `am5.Animation` work as types.
|
|
1314
|
-
- **
|
|
1315
|
-
-
|
|
1316
|
-
|
|
1317
|
-
|
|
1318
|
-
|
|
1319
|
-
|
|
1320
|
-
-
|
|
1321
|
-
-
|
|
1322
|
-
-
|
|
1323
|
-
-
|
|
1324
|
-
|
|
1325
|
-
**
|
|
1326
|
-
- `resources` gives a JSON config the geodata and locales it names (`"geoJSON": "am5geodata_worldLow"`, `"locale": "am5locales_de_DE"`) when they aren't globals, as with npm imports. It's taken by:
|
|
1327
|
-
- `JsonParser.parse(config, { parent, resources: { am5geodata_worldLow } })`;
|
|
1328
|
-
- `ChartSerializer.new(root, { resources })`, which then writes those packs by name instead of copying them whole;
|
|
1329
|
-
- `<am5-chart>` (`element.resources`);
|
|
1330
|
-
- the framework packages' `resources` prop.
|
|
1331
|
-
|
|
1332
|
-
A name that can't be found now logs a warning. Before, the map was just blank. See "Serializing to JSON" and `references/json.md`.
|
|
1333
|
-
- `<am5-chart>` and the framework packages take a theme with its settings: `[am5themes_Adaptive, { baseColor: "#4150a0" }]`. The `themes` attribute takes the same as JSON: `themes='["Animated", ["Adaptive", { "baseColor": "#4150a0" }]]'`.
|
|
1334
|
-
- The framework packages' new versions (react 5.0.1, vue 5.0.2, angular 5.0.1, svelte 5.0.3, react-native 5.0.1) have both, and the web ones need amCharts 5.21.4 or later.
|
|
1335
|
-
|
|
1336
|
-
**New in 5.21.3 (2026-10-21):**
|
|
1337
|
-
- `ColorSet` `repeatLightness`: themes that reuse their colors (Adaptive, Monochrome, Kelly, Material, Nord, Pastel and others, but not Colorblind or Patterns) now make each repeat of the list 10% lighter. For the old behavior, set `repeatLightness: 0` through a theme rule, `rule("ColorSet").set("repeatLightness", 0)`: the color sets of a root share one list. In the Adaptive and Monochrome theme settings, use `false`. See "ColorSet".
|
|
1338
|
-
- JSON: palette colors are written as `"@colors.getIndex(n)"`, so they follow the theme the config is parsed with. A `step` or `passOptions` set on a chart's colors round-trips without the theme's palette. Data-item loops that differ per item are saved per item. See "Serializing to JSON".
|
|
1339
|
-
- Maps: d3 projections with a shape of their own (HEALPix, Armadillo, Berghaus, interrupted and polyhedral) display properly, and switching projections at zoom level 1 shows the whole map again.
|
|
1340
|
-
|
|
1341
|
-
**New in 5.21.2 (2026-10-14):**
|
|
1342
|
-
- Interface color `warning`: a yellow between `negative` and `positive` (default `#f2c230`; themes with their own `positive`/`negative` have a matching one), for the middle of a bad-to-good scale: `root.interfaceColors.get("warning")`.
|
|
1343
|
-
- `am5.Color.interpolateColors(position, colors, mode?)`: a color on a scale through any number of colors, evenly spaced (`position` 0–1, clamped; `mode` `"rgb"` (default) or `"hsl"`). Through `[negative, warning, positive]` it avoids the brown middle of `Color.interpolate(t, negative, positive)`. See "Colors".
|
|
1344
|
-
- Heat rules: `stops` (numbers, percents or colors, all of one kind) in place of `min`/`max`, for a scale through more than two values. `HeatLegend`: `colors` in place of `startColor`/`endColor`, a gradient through them with `stepCount: 1` or one step per color otherwise (`stepCount` is then ignored). See "Heat rules".
|
|
1345
|
-
- `am5themes_Adaptive` and `am5themes_Monochrome`: `interleave`, `mapShade` and `keepContrast` (all off by default). See "Parameterized themes".
|
|
1346
|
-
- Fixed: a ColorSet `step` with a theme that reuses its colors used only two or three of them (word clouds and treemaps with Nord, Pastel or Adaptive), see "ColorSet"; `RadialGradient` with pixel `x`/`y` was off-center on radar fills and similar shapes in 5.21.1.
|
|
1347
|
-
|
|
1348
|
-
**Behavior changes / fixes (5.21.1, 2026-10-13)** — no workaround needed any more:
|
|
1349
|
-
- `root.timezone`: charts were up to 16 times slower with it, and grid, labels, data groups and date math could be an hour off around a daylight saving change. A `DateAxis` grid of several hours now stays on the clock after a DST change (where the clocks skip a grid time, the line goes at the jump). `PeriodSelector` and `DateRangeSelector` follow `root.timezone`/`root.utc` (they used the viewer's time zone). Date formats `Z`, `ZZ`, `x`, `i`, `I` are right with `root.timezone`, and `YYYY`, `ww`, `W`, `DDD` honor `root.utc`.
|
|
1350
|
-
- `DataProcessor`: string dates in `dateFields` without a `dateFormat` were all read as 1 January 1970. Now the browser's `Date` parses them, and a date-only `"2024-03-15"` is midnight UTC. See "Data processor".
|
|
1351
|
-
- A chart in a container scaled with CSS (`transform` or `zoom`) was scaled twice, and clicks hit the wrong elements.
|
|
1352
|
-
- Maps: a `zoomLevel` set before the map loaded was ignored or left the map blank; `MapSankeySeries` bands follow `linkColorMode` and node fill changes, and nodes without coordinates are drawn; raised map lines (`MapLine` `altitude`) draw 3–4 times faster.
|
|
1353
|
-
- `RadialGradient` is centered on map polygons, line and area fills and bullets (with `target` set, on the target). `Picture`: changing a shadow setting after the image loaded no longer removes the image. `CurveChart`: a path scaled down to fit no longer gets far too many labels and grid lines. Responsive theme: XY axis ticks on small charts are no longer moved inside the plot.
|
|
1354
|
-
|
|
1355
|
-
**New in 5.21.0 (2026-10-08):**
|
|
1356
|
-
|
|
1357
|
-
*Rendering, export, chart element*
|
|
1358
|
-
- SVG rendering: `renderer: am5.SVGRenderer` in `Root.new()` settings (only when the root is created), or `am5.Root.defaultRenderer = am5.SVGRenderer` before creating roots. Canvas stays the default; charts look and behave the same; blend modes `DST_OVER`, `SRC_ATOP` and `XOR` are canvas-only. See "Root element setup".
|
|
1359
|
-
- `am5.renderToSVG(rootOrElement, options?)` — SVG markup of the chart (or of one element, e.g. `pixelSeries.pixels`) as last drawn, from either renderer; screen readers read it as one image named by `title` / the Root `ariaLabel`. Exporting plugin: `"svg"` format (`download("svg")`, `getSVG()`, `exportSVG()`, `svgOptions`), listed in `ExportingMenu` by default. See "Exporting".
|
|
1360
|
-
- `<am5-chart>` element — a chart from a JSON config (`config` or `src`), with `themes` and `renderer="svg"`; load `element.js` after `plugins/json.js`, or with npm import `defineChartElement` from `@amcharts/amcharts5/element` and call it. See "Serializing to JSON".
|
|
1361
|
-
- The npm package now ships `AGENTS.md`, `docs/` (a bundled copy of these notes, possibly older) and `examples/<name>/index.ts` (62 also as `config.json`; `examples/examples.json` lists what each shows) — when the package is installed, those examples are verified starting points.
|
|
1362
|
-
|
|
1363
|
-
*Maps* (details and snippets in `references/map.md`)
|
|
1364
|
-
- `am5map.MapRasterSeries` — a whole-world equirectangular image (e.g. `https://cdn.amcharts.com/lib/5/geodata/images/earthDay2048.jpg`) reprojected as the map turns and zooms (WebGL2 where it can); `nightSrc` + `sunDate`/`sunPosition` show day and night.
|
|
1365
|
-
- `am5map.NightSeries` — shades the night side in twilight steps and shows the sun: `sunDate` (`"now"`, timestamp, date string or `Date`) or `sunPosition`; `sunAltitude` (metres) keeps the sun in view past a globe's edge. `am5map.getSunPosition(date?)` returns the `{ longitude, latitude }` where the sun is overhead.
|
|
1366
|
-
- `am5map.PixelMapSeries` — polygons drawn as a grid of pixels (`pixelType`, `step`, `uniform`, `columnHeight` with `MapPolygon` `pixelHeight`, or the series' `pixelHeightFunction`); heat rules, states and tooltips work as on `MapPolygonSeries`.
|
|
1367
|
-
- `MapLine` `altitude` (metres; each leg arcs) and `MapPointSeries` `altitudeField` (no default) raise lines and points; `MapPointSeries` `surfaceBullets` lays bullets on the map surface; `MapChart` `autoHome` goes home once loaded; `MapPolygonSeries` `clickZoom` zooms to a clicked polygon and back.
|
|
1368
|
-
|
|
1369
|
-
*Core*
|
|
1370
|
-
- `autoAppear` / `appearDuration` / `appearDelay` on every element — `appear()` as settings, so JSON configs get the opening animation. See "Animations".
|
|
1371
|
-
- `Root` `forcedColors` (default `true`) — interface colors follow Windows High Contrast. See "Accessibility".
|
|
1372
|
-
- `Scrollbar` `outsideAxes` — `true` puts a chart's scrollbar beyond the axes on its side, `false` between them and the plot; unset, the chart decides. Only for `scrollbarX`/`scrollbarY`. See `references/ui-elements.md`.
|
|
1373
|
-
- `ChartSerializer`/`JsonParser`: colors from `root.interfaceColors` are saved as `"@root.interfaceColors.get('…')"` references (they follow the theme the config is parsed with); data-item loops, hidden series, elements added to plot/axis containers, `Date` values and more are now saved. See "Serializing to JSON".
|
|
1374
|
-
- Accessibility: `ariaExpanded` setting, `Modal` `ariaLabel`, keyboard changes (ESC, SPACE, arrows in draggable groups). See "Accessibility".
|
|
1375
|
-
- New locale prompts, translated in all locales: "OK", "Cancel", "Delete", "Settings", "Expand", "Move Up", "Move Down".
|
|
1376
|
-
|
|
1377
|
-
**Behavior changes (5.21.0)** — existing code may now render or act differently:
|
|
1378
|
-
- A hidden element (`visible: false`, `forceHidden` or `hide()`) no longer takes up space in a container sized to its content — e.g. a hidden XY scrollbar no longer leaves an empty band above the plot.
|
|
1379
|
-
- `DataProcessor` `emptyAs` replaces only `null`, `undefined` and `""` — no longer `0` and `false`.
|
|
1380
|
-
- `Label` `fillOpacity: 0` now hides the text (it was ignored). `strokeWidth: 0` now draws no line (was 1 px) and `shadowOpacity: 0` no shadow (was a full one).
|
|
1381
|
-
- Heat rules: `minValue: 0` / `maxValue: 0` are honored (the data's lowest/highest value was used instead).
|
|
1382
|
-
- Bullets with `stacked: "up"` (or `"auto"` in the lower half) on a vertical series stack instead of overlapping.
|
|
1383
|
-
- `calculateAggregates` on non-XY series (pie, map heat maps): `valueChange`, `valueChangePercent` and the like are numbers now (were `NaN`), and right on bubble series.
|
|
1384
|
-
- `Gantt`: the category axis' `colorField` and `nameField` are honored (bar colors were always read from `color`).
|
|
1385
|
-
- `Sunburst` ignores `singleBranchOnly` (always `true`). `StockToolbar` `focusable` now defaults to `true`.
|
|
1386
|
-
- Responsive theme: minor axis labels are hidden only on charts 600 px or smaller (was 1000 px), so turned-on minor labels show on mid-size charts.
|
|
1387
|
-
- `PatternSet` starts over from its first pattern past the end of its list (elements after the 17th got no pattern).
|
|
1388
|
-
- `DurationFormatter`: codes `H`, `D`, `Y`, `K`, `k`, `n` work (as `h`, `d`, `y`, `h`, `h`, `S` — e.g. `"HH:mm:ss"` gave `NaN`); durations between a month and a year use the month formats again (`1m 15d 00:00:00`, not `45d 00:00:00`), which `DurationAxis` labels show.
|
|
1389
|
-
- `am5.CSVParser` honors `skipEmpty: false` (empty lines were always skipped). `series.updateData([])` removes every data item (it kept the first).
|
|
1390
|
-
- A `fontSize` given as a number in a string (`"8"`) counts as pixels (was ignored). Filters (`brightness`, `saturate`, `blur`, …) combine instead of replacing each other, and one set back to neutral turns off.
|
|
1391
|
-
- A logarithmic `ValueAxis` with values ≤ 0 logs a console warning pointing to `treatZeroAs` (it silently drew nothing).
|
|
1392
|
-
- `am5.Color.alternative(color)` without light/dark colors returns black for light colors (it always returned white). Date format `YYYY` is right west of UTC. `Label` `maxChars` cut at a word boundary uses the `ellipsis` setting.
|
|
1393
|
-
- Exporting: CSV/HTML with `pivot: true` follow `dataFieldsOrder` (were reversed); HTML `headerClass` is applied; `maxHeight` shrinks the image.
|
|
1394
|
-
- Fixes that remove old workarounds (details in the references): map `goHome()` before the map is ready or on a globe, `zoomToGeoBounds()` duration and bounds, dragging a zoomed map to its edges, `lineType` changes; `innerRadius: am5.percent(0)` on pie/radar/gauge; `AxisRendererRadial` negative `radius`; `SmoothedRadarLineSeries` `tension`, `ForceDirected` forces, `Partition`/`Sunburst` `nodePadding`, `Sunburst` angles and `Chord` `sort: "none"` changed after drawing; `WordCloud` word filtering (`minValue` / `minWordLength` / `excludeWords`); stock indicator column colors; `GaplessDateAxis` with grouped data and `root.timezone`.
|
|
1395
|
-
|
|
1396
|
-
**Behavior changes / fixes (5.20.6 – 5.20.8)** — no workaround needed any more:
|
|
1397
|
-
- `CategoryAxis` (5.20.6): series data no longer has to follow the axis-category order for every item to be drawn (e.g. Gantt-like column charts sorted by date). Line series still connect points in data order.
|
|
1398
|
-
- Logarithmic `ValueAxis` over a wide range labels its grid with round powers of ten (5.20.6).
|
|
1399
|
-
- Content added to an `axisHeader` after the chart is built (e.g. a legend) now makes the axis leave room instead of covering it (5.20.7).
|
|
1400
|
-
- A `Container`'s `background` with its own `templateField` now reads the container's data item (5.20.7), so a per-bullet label background works: `am5.Label.new(root, { text: "{valueY}", populateText: true, background: am5.RoundedRectangle.new(root, { templateField: "labelBg" }) })` with `labelBg: { fill: am5.color(0xff0000) }` in the data row.
|
|
1401
|
-
- `am5.CSVParser.parse("")` no longer loops until "Invalid array length" (5.20.7) — an empty server response is safe. It returns `[]` with `useColumnNames: true`, but `[{}]` (one empty row) with default options, so check for that before `data.setAll()`.
|
|
1402
|
-
- JSON: `JsonParser` resolves references that point further down the config, and user `themeTags` are serialized — see *JSON config / serialization* below.
|
|
1403
|
-
|
|
1404
|
-
**New settings / methods worth knowing:**
|
|
1405
|
-
|
|
1406
|
-
*Declared animations, links, map points on lines (5.20.6 – 5.20.8)*
|
|
1407
|
-
- `animations` setting on **every** element (5.20.8): an array of `IDeclaredAnimation` entries `{ key, from?, to, duration, delay?, loops?, yoyo?, easing?, ease?, target? }` — animations described as data (`loops: 0` = forever, `easing` by **name**, `target: "dataItem"` for data-item values). Round-trips through JSON. `IDeclaredAnimation` is not exported from the package index. See "Animations" above for the snippet, defaults and the `from` caveat.
|
|
1408
|
-
- `am5.ease.byName(name, mode?)` / `am5.ease.easingInfo(fn)` (5.20.8) — easing function ↔ name; only the 8 named base easings (and `out`/`inOut`/`yoyo` of them) have names. See "Easing functions" above.
|
|
1409
|
-
- `ChartSerializer`: `runningAnimations` (5.20.8, default `true`) — saves endless code-started loops as `animations` entries. See "Serializing to JSON" above.
|
|
1410
|
-
- `Series` links (5.20.7): `urlField` (no default — links are off until set) names the data field holding a URL; the data item's `url` field gets it. Clicking the item's bullet (any series), column (`ColumnSeries`, candlestick, OHLC, Gantt…), slice (pie, funnel, pyramid, pictorial, Venn), `MapPolygon` or `MapLine` opens it in `linkTarget` (default `"_self"`; `"_blank"` opens with `noopener`; a chart inside an iframe usually wants `"_blank"` or `"_top"`). `cursorOverStyle: "pointer"` is set automatically unless you set one. `javascript:`/`data:`/`vbscript:` URLs are never opened. Override `series.openUrl(dataItem)` to intercept clicks. `urlField` can be set after the data, and a URL added later (`data.setIndex()`) links too. **Not linked:** hierarchy nodes, flow nodes/links, word-cloud labels, `MapSankeySeries` nodes.
|
|
1411
|
-
- `MapPointSeries` (5.20.6): `lineIdField` (default `"lineId"`), `positionOnLineField` (`"positionOnLine"`), `autoRotateField` (`"autoRotate"`), `autoRotateAngleField` (`"autoRotateAngle"`) — a point on a line can be a plain data row `{ lineId: "jfk-lhr", positionOnLine: 0.5, autoRotate: true }` instead of `pushDataItem({ lineDataItem, positionOnLine })`, so it is saved by `ChartSerializer`. Data values of `autoRotate`/`autoRotateAngle` win over the bullet's. See `references/map.md`.
|
|
1412
|
-
- `MapPointSeries` (5.20.8): an auto-rotating point turns round to face its travel direction on the way back — **only** while a bullet-sprite `animations` entry (`target: "dataItem"`, `key: "positionOnLine"`, e.g. with `yoyo: true`) moves it toward the line start. A point moved by `dataItem.animate()` in code is not flipped; that code must turn it.
|
|
1304
|
+
- **Geodata 5.2.0:** Nauru is named "Naoero"; its id is `NR`.
|
|
1305
|
+
- react-native 5.0.3 loads 5.22.0, so its `themes` take `"ResponsiveMax"`.
|
|
1306
|
+
|
|
1307
|
+
**Settings and methods worth knowing** (newer than most training data):
|
|
1308
|
+
|
|
1309
|
+
*Declared animations, links, map points on lines*
|
|
1310
|
+
- `animations` setting on **every** element: an array of `IDeclaredAnimation` entries `{ key, from?, to, duration, delay?, loops?, yoyo?, easing?, ease?, target? }` — animations described as data (`loops: 0` = forever, `easing` by **name**, `target: "dataItem"` for data-item values). Round-trips through JSON. `IDeclaredAnimation` is not exported from the package index. See "Animations" above for the snippet, defaults and the `from` caveat.
|
|
1311
|
+
- `am5.ease.byName(name, mode?)` / `am5.ease.easingInfo(fn)` — easing function ↔ name; only the 8 named base easings (and `out`/`inOut`/`yoyo` of them) have names. See "Easing functions" above.
|
|
1312
|
+
- `ChartSerializer`: `runningAnimations` (default `true`) — saves endless code-started loops as `animations` entries. See "Serializing to JSON" above.
|
|
1313
|
+
- `Series` links: `urlField` (no default — links are off until set) names the data field holding a URL; the data item's `url` field gets it. Clicking the item's bullet (any series), column (`ColumnSeries`, candlestick, OHLC, Gantt…), slice (pie, funnel, pyramid, pictorial, Venn), `MapPolygon` or `MapLine` opens it in `linkTarget` (default `"_self"`; `"_blank"` opens with `noopener`; a chart inside an iframe usually wants `"_blank"` or `"_top"`). `cursorOverStyle: "pointer"` is set automatically unless you set one. `javascript:`/`data:`/`vbscript:` URLs are never opened. Override `series.openUrl(dataItem)` to intercept clicks. `urlField` can be set after the data, and a URL added later (`data.setIndex()`) links too. **Not linked:** hierarchy nodes, flow nodes/links, word-cloud labels, `MapSankeySeries` nodes.
|
|
1314
|
+
- `MapPointSeries`: `lineIdField` (default `"lineId"`), `positionOnLineField` (`"positionOnLine"`), `autoRotateField` (`"autoRotate"`), `autoRotateAngleField` (`"autoRotateAngle"`) — a point on a line can be a plain data row `{ lineId: "jfk-lhr", positionOnLine: 0.5, autoRotate: true }` instead of `pushDataItem({ lineDataItem, positionOnLine })`, so it is saved by `ChartSerializer`. Data values of `autoRotate`/`autoRotateAngle` win over the bullet's. See `references/map.md`.
|
|
1315
|
+
- `MapPointSeries`: an auto-rotating point turns round to face its travel direction on the way back — **only** while a bullet-sprite `animations` entry (`target: "dataItem"`, `key: "positionOnLine"`, e.g. with `yoyo: true`) moves it toward the line start. A point moved by `dataItem.animate()` in code is not flipped; that code must turn it.
|
|
1413
1316
|
|
|
1414
1317
|
*Themes & styling*
|
|
1415
|
-
-
|
|
1416
|
-
-
|
|
1417
|
-
- `rotateShapes`
|
|
1418
|
-
- `Series`: `fillGradient` / `strokeGradient` settings, handed to bullets (the series' own fills, lines and columns don't use them: set gradients on `fills.template` / `columns.template` / `strokes.template`). A bullet `Graphics` with no paint of its own (`fill`, `fillGradient`, `fillPattern`, `stroke`, `strokeGradient`)
|
|
1318
|
+
- Palette themes: `Midnight`, `Ember`, `Nord`, `Pastel`, `Colorblind`, `Patterns`, `Petroleum`, `Savanna`, plus `*Dark` variants of most palettes. Two parameterized factory themes, `Monochrome` and `Adaptive` — see "Parameterized themes" above.
|
|
1319
|
+
- Fill patterns `am5.StarPattern` (`radius`, `innerRadius`, `spikes`, `gap`, `checkered`) and `am5.TrianglePattern` (`maxWidth`, `maxHeight`, `gap`, `checkered`).
|
|
1320
|
+
- `rotateShapes` on `RectanglePattern`/`StarPattern`/`TrianglePattern`: `rotation` then spins each shape around its own center instead of the whole grid — tiles seamlessly and is much faster. Prefer it over a whole-pattern `rotation` on large tiles.
|
|
1321
|
+
- `Series`: `fillGradient` / `strokeGradient` settings, handed to bullets (the series' own fills, lines and columns don't use them: set gradients on `fills.template` / `columns.template` / `strokes.template`). A bullet `Graphics` with no paint of its own (`fill`, `fillGradient`, `fillPattern`, `stroke`, `strokeGradient`) inherits all of them from its series — and on pie, funnel, flow and hierarchy charts, from its own slice/node.
|
|
1419
1322
|
|
|
1420
1323
|
*XY charts*
|
|
1421
1324
|
- `XYChart`: `strokeWidths` (array of pixel widths) and `strokeDasharrays` (array of dash arrays) — cycled across line series as they are added, exactly like `colors`. Lets series be told apart without relying on color, e.g. with the `Patterns` theme.
|
|
1422
1325
|
- `XYCursor`: `clickTolerance` (default `0`) — how many pixels outside the plot area a press may start and still begin a zoom/selection. The selection itself still starts at the plot edge.
|
|
1423
|
-
- `XYSeries`: a value field (`valueYField`, `openValueYField`, …) can
|
|
1424
|
-
- Column series (`ColumnSeries`, `CandlestickSeries`, `OHLCSeries`, …)
|
|
1425
|
-
- `Scrollbar
|
|
1326
|
+
- `XYSeries`: a value field (`valueYField`, `openValueYField`, …) can be changed after creation — re-set the series data afterwards for it to take effect. A series can also be reassigned to a different `xAxis`/`yAxis` after creation.
|
|
1327
|
+
- Column series (`ColumnSeries`, `CandlestickSeries`, `OHLCSeries`, …): `colorByDataItem: true` (default `false`) gives each column its own color from the series' `colors` (`ColorSet`) setting — the series makes its own `ColorSet` if none is given. The color lands on the data item's `fill` field. Prefer this over an adapter on `columns.template` `fill`: it is declarative and survives JSON serialization.
|
|
1328
|
+
- `Scrollbar`: `opposite: true` (default `false`) puts a chart's `scrollbarX` **below** the plot and `scrollbarY` to the **left**, instead of above / right. Only affects scrollbars set via `chart.set("scrollbarX"/"scrollbarY", …)`. This is a **different** setting from `opposite` on `AxisRendererX`/`AxisRendererY`.
|
|
1426
1329
|
|
|
1427
|
-
*WordCloud
|
|
1330
|
+
*WordCloud*
|
|
1428
1331
|
- `svgPath` arranges words into a shape (experimental), with `maskByShape` to clip them to the outline and `shapeTolerance` to control spill (negative = padding inside). See `references/wordcloud.md`.
|
|
1429
1332
|
- `randomizeAngles: false` cycles `angles` in order for a reproducible layout; `allowNesting: false` packs words as non-overlapping bounding boxes (use it when labels have opaque backgrounds).
|
|
1430
|
-
- `angles`
|
|
1333
|
+
- `angles` accepts **any** angle (e.g. `[0, -30, -45]`).
|
|
1431
1334
|
|
|
1432
1335
|
*Core / events*
|
|
1433
|
-
-
|
|
1434
|
-
- `Root`: `sanitizeHTML` (
|
|
1435
|
-
- `Root`: `ariaLabel` is
|
|
1436
|
-
- `Label`: `oversizedBehavior: "truncate"`
|
|
1437
|
-
- A `Container`'s `Rectangle`/`RoundedRectangle` background
|
|
1438
|
-
- `
|
|
1439
|
-
- `
|
|
1440
|
-
|
|
1441
|
-
|
|
1442
|
-
|
|
1443
|
-
-
|
|
1444
|
-
- `JsonParser
|
|
1445
|
-
-
|
|
1446
|
-
|
|
1447
|
-
|
|
1448
|
-
- `
|
|
1449
|
-
- Map data rows (5.20.7) no longer carry the geodata's own feature properties (`name`, `CNTRY`, `TYPE`); a row left with only its id is dropped.
|
|
1450
|
-
- `animations` round-trip, and an endless code-started loop (`loops: Infinity`, nameable easing) is written as an `animations` entry with its key removed from the settings (5.20.8, `runningAnimations`, default `true`). A loop started on a data item in code is **not** saved in 5.20.8 (it is since 5.21.0).
|
|
1451
|
-
|
|
1452
|
-
*Bullets on non-XY charts (5.20.2)*
|
|
1453
|
-
- `ArcDiagram`: bullets on nodes are now placed on the node circle, `locationX`/`locationY` being fractions of it (before 5.20.2 they were created but never positioned). Flow charts (`Sankey`/`Chord`): node bullets are children of the node, drawn above its shape and below its label, positioned relative to the node. `FunnelSeries`/`PyramidSeries`: bullet `locationX`/`locationY` follow the slice's sloping edges instead of its bounding box.
|
|
1336
|
+
- `globalpointerdown` event on all elements — fires on a press anywhere on the chart surface, mirroring `globalpointermove`/`globalpointerup`.
|
|
1337
|
+
- `Root`: `sanitizeHTML` (default `true`) — dynamically-set HTML (`html`/`labelHTML`, HTML tooltips, modal content) is sanitized; set `false` in code to opt out. A JSON config's `root` section can't turn it off unless parsed with `trusted: true`. Exports have `escapeFormulas` (default `true`) to guard CSV/XLSX against formula injection.
|
|
1338
|
+
- `Root`: `ariaLabel` is applied to the `<div>` holding the chart's focusable elements.
|
|
1339
|
+
- `Label`: `oversizedBehavior: "truncate"` ignores `maxHeight` (there is no way to truncate text vertically).
|
|
1340
|
+
- A `Container`'s `Rectangle`/`RoundedRectangle` background defaults `crisp` to `true` unless set explicitly.
|
|
1341
|
+
- A `Container`'s `background` with its own `templateField` reads the container's data item, so a per-bullet label background works: `am5.Label.new(root, { text: "{valueY}", populateText: true, background: am5.RoundedRectangle.new(root, { templateField: "labelBg" }) })` with `labelBg: { fill: am5.color(0xff0000) }` in the data row.
|
|
1342
|
+
- `Root`: `fontFamily`, `fontSize` (number or string) and `fontWeight` (`"normal" | "bold" | "bolder" | "lighter"`, or `"100"` … `"900"`) settings — defaults for **all** text elements unless overridden on an element. Set them in `am5.Root.new("chartdiv", { fontFamily: "Inter" })` or `root.setAll({...})` instead of a custom theme rule on `Label`.
|
|
1343
|
+
- `am5.SerialChartContainer` — a directly usable `SerialChart` whose `seriesContainer` sits inside a `ZoomableContainer` (exposed as `chart.zoomableContainer`), so series such as `ForceDirected` can be zoomed and panned. Exported from the **`am5` root module**, not a chart package. Optional `zoomTools` setting takes a `ZoomTools` instance whose `target` is pointed at the series container automatically. Bullets on its series are drawn, flow-chart bullets included. See `references/hierarchy.md`.
|
|
1344
|
+
|
|
1345
|
+
*JSON config / serialization*
|
|
1346
|
+
- Gantt charts serialize and parse. Cross-references are written as references (`"@series.get('fill')"`) instead of copies; large values (a map's `geoJSON`, a `Root`'s locale) are written as the name of the pack they came from and rebuilt on parse.
|
|
1347
|
+
- `JsonParser` resolves **forward references**: a setting/property naming a ref defined further down the config is resolved after the rest instead of throwing "Could not find ref" — a legend inside an `axisHeader` naming a series round-trips. Axis-range `axis`/`series` lookups are immediate, so keep those ordered.
|
|
1348
|
+
- Map data rows written by `ChartSerializer` don't carry the geodata's own feature properties (`name`, `CNTRY`, `TYPE`); a row left with only its id is dropped.
|
|
1349
|
+
|
|
1350
|
+
*Bullets on non-XY charts*
|
|
1351
|
+
- `ArcDiagram`: bullets on nodes are placed on the node circle, `locationX`/`locationY` being fractions of it. Flow charts (`Sankey`/`Chord`): node bullets are children of the node, drawn above its shape and below its label, positioned relative to the node. `FunnelSeries`/`PyramidSeries`: bullet `locationX`/`locationY` follow the slice's sloping edges instead of its bounding box.
|
|
1454
1352
|
- A bullet `Graphics` with no paint of its own takes the color of **its own slice or node** on pie, funnel, flow and hierarchy charts — so it is the same color as what it sits on and **invisible** unless offset, stroked, or given a contrasting `fill` deliberately. Setting `fill` on the bullet sprite turns the inheritance off.
|
|
1455
1353
|
|
|
1456
1354
|
*Maps*
|
|
1457
|
-
- `MapChart
|
|
1458
|
-
- `MapLineSeries
|
|
1459
|
-
- `MapChart`: `projectionName`
|
|
1460
|
-
- `MapSankeySeries`
|
|
1461
|
-
- `MapPointSeries` defaults changed to `longitudeField: "longitude"`, `latitudeField: "latitude"` (5.16.1).
|
|
1355
|
+
- `MapChart`: `doubleClickZoom` (default **`true`**: a double click/tap zooms in, shift + double click zooms out; set `false` to opt out). On maps panned by rotating (`panX: "rotateX"` / `panY: "rotateY"`) the clicked point rotates to the center, otherwise it stays under the pointer. `boxZoom: "none" | "drag" | "shift" | "ctrl" | "alt"` (default `"none"`) is **not a boolean** — it names the key held while dragging a rectangle to zoom into; `"drag"` needs no key, so pair it with `panX`/`panY: "none"`. The rectangle is the readonly `chart.boxZoomSelection` element (a `Rectangle`). There are no keyboard-navigation settings on `MapChart`.
|
|
1356
|
+
- `MapLineSeries`: `pointIds` data field (`{ pointIds: ["JFK", "LAX"] }`) names the `MapPointSeries` points a line connects, looked up in the series given by the `pointSeries` setting; `pointIdsField` (default `"pointIds"`) renames the field. `pointsToConnect` wins if both are set. See `references/map.md`.
|
|
1357
|
+
- `MapChart`: `projectionName` — string alternative to `projection`, e.g. `"geoOrthographic"`, mainly for JSON config. Register extra ones with `am5map.registerProjection()`. Unused bundled projections tree-shake away.
|
|
1358
|
+
- `MapSankeySeries` — Sankey overlaid on a map; it resolves `sourceId`/`targetId` once the `polygonSeries` geoJSON loads, so no `datavalidated` wrapper is needed. See `references/map.md`.
|
|
1462
1359
|
|
|
1463
1360
|
*Hierarchy & axes*
|
|
1464
|
-
- `Tree`: `fitNodes` (
|
|
1465
|
-
- `ValueAxis`: `syncZeros` (
|
|
1466
|
-
- `Hierarchy`: `parentIdField` setting + `setFlatData(data)` method
|
|
1361
|
+
- `Tree`: `fitNodes` (exclude hidden nodes from layout), `nodeSeparation` (custom node-spacing fn), `clustered` (dendrogram layout — leaves at same depth).
|
|
1362
|
+
- `ValueAxis`: `syncZeros` (align zero across synced axes — needs `syncWithAxis`).
|
|
1363
|
+
- `Hierarchy`: `parentIdField` setting + `setFlatData(data)` method — feed flat `{id, parentId}` data instead of nested `children`.
|
|
1467
1364
|
|
|
1468
1365
|
*Stock*
|
|
1469
|
-
- Indicator numeric settings
|
|
1470
|
-
- Volume Profile
|
|
1366
|
+
- Indicator numeric settings enforce min/max limits. `IIndicatorEditableSetting` has `scale`, `maxValue` and `step`.
|
|
1367
|
+
- Volume Profile spreads each bar's volume across its full high/low range. See `references/stock.md`.
|
|
1471
1368
|
|
|
1472
1369
|
*All entities*
|
|
1473
|
-
- `onDebounced(key, cb, delay)` / `offDebounced(key, cb?)` and `onPrivateDebounced` / `offDebouncedPrivate`
|
|
1474
|
-
- `once(key, cb)` and `onceDebounced(key, cb, delay)`
|
|
1475
|
-
- `Label`: `fontFamily: "inherit"`
|
|
1370
|
+
- `onDebounced(key, cb, delay)` / `offDebounced(key, cb?)` and `onPrivateDebounced` / `offDebouncedPrivate` — fire once after rapid changes settle.
|
|
1371
|
+
- `once(key, cb)` and `onceDebounced(key, cb, delay)` — like `on()`/`onDebounced()` for a **settings** key, but the callback fires only the first time that setting changes, then removes itself. Both return an `IDisposer`. (Distinct from `events.once("eventName", …)` for events.)
|
|
1372
|
+
- `Label`: `fontFamily: "inherit"` uses the chart container's computed font.
|
|
1476
1373
|
|
|
1477
1374
|
## Verify unfamiliar API before using it
|
|
1478
1375
|
|