Animation Config
Configure the chart animation settings.
Every property is optional and falls back to its default. Property anchors are stable: link to any entry as #animation.propertyName, and to a member of a nested property as #animation.propertyName.memberName.
Properties
animate
Whether all animation should be enabled or disabled.
The master switch for staged animation. When false, config and data changes apply instantly. When true, each update plays up to three sequential phases — axis expansion, value change, axis contraction — skipping phases it does not need, and each phase’s duration scales with the size of its change (small updates play faster than the configured maximum). Width/height changes re-layout the chart instantly either way. The user’s reduced-motion preference can also disable animation — see accessibility.respectReducedMotion.
- Default:
true - Validation:
should be a boolean - Used in: Multiple Axes · Picket Fence Bars · Pos/Neg Picket Fence Bars · +2 more
contractionDuration
The maximum duration for the axis contraction animation phase when new data is removed from the chart.
Duration (in milliseconds) of the axis contraction phase, which plays last when the settled data needs smaller axis domains.
- Default:
1000 - Validation:
should be a number >= to 0 - Used in: Staged animation · Axis Filtering Adjustment · Multiple Axes · Threshold Line · +6 more
expansionDuration
The maximum duration for the axis expansion animation phase when new data is added to the chart.
Duration (in milliseconds) of the axis expansion phase, which plays first when an update needs larger axis domains (new categories or larger values) so incoming data has room to land.
- Default:
1000 - Validation:
should be a number >= to 0 - Used in: Staged animation · Axis Filtering Adjustment · Multiple Axes · Threshold Line · +6 more
focusDuration
The duration of animation showing the transition between focus on a specific series or category value.
Duration (in milliseconds) of focus transitions — the emphasis change between focused/defocused styling when a series or category gains or loses focus via hover, click, or the legend.
- Default:
1000 - Validation:
should be a number >= to 0 - Used in: Multiple Axes · Picket Fence Bars · Pos/Neg Picket Fence Bars · +2 more
initialDuration
The maximum duration for the initial animation when chart data is first loaded.
Duration (in milliseconds) of the first render animation when the chart mounts with data.
- Default:
1000 - Validation:
should be a number >= to 0 - Used in: Axis Filtering Adjustment · Multiple Axes · Threshold Line · +6 more
valueChangeDuration
The maximum duration for the value change animation phase when data in the chart changes.
Duration (in milliseconds) of the value change phase, which tweens values to their new positions and also plays category transitions (categories added/removed/reordered) and series transitions (series added, removed, or filtered via the legend).
- Default:
1000 - Validation:
should be a number >= to 0 - Used in: Staged animation · Axis Filtering Adjustment · Multiple Axes · Threshold Line · +6 more