Transition

Components/Animations

Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/transition

Overview

Copy

Transition is a wrapper that allows animations of other components.

Do

  • Use it to animate components that need a visual explanation of their origin or termination. For example tooltip appearance animation.
  • Use it for animated transitions between object states to provide clarity of change.

Don't

  • Don't use it to animate interface elements for sake of effect.
  • Don't use it for idle animations, like loading spinner.

Feature examples

Enter Animation

Make component appear using these four animation types:

  • Fade In - use it for sudden appearances or state changes.
  • Move In - use it to emphasize direction from which object appears. It supports 4 possible directions.
  • Expand - use it for objects that appear in between the content. It supports 4 possible directions.
  • ScaleUp - use it to explain that object appears from a certain point. It supports 9 possible directions.

To see all possible direction options please check API.

Copy

Exit Animation

Make components disappear using these four animation types:

  • Fade Out - use it for appearances or state changes.
  • Move Out - use it to emphasize the direction to which object disappears. It supports 4 possible directions.
  • Collapse - use it for objects that disappear in between the content. It supports 4 possible directions.
  • ScaleDown - use it to explain that an object disappears to a certain point. It supports 9 possible directions.

To see all possible direction options please check API.

Copy

Swoosh

The swoosh preset fades content in while it drifts and stretches in from one edge, and out the way it came. It pairs with layout components that slide into view, such as a side panel.

Set the same direction on the enter and exit animation so the content retreats toward the edge it entered from. The motion is skipped automatically when the user prefers reduced motion.

Copy

Duration

Use it to determine how long animation plays. Choose form 6 following properties:

  • Fast01 - 100ms. Use for small objects such as Buttons or Toggles.
  • Fast02 - 150ms. Use for larger than small objects such as Tooltips or Section Helpers.
  • Medium01 - 200ms. Use for medium size objects like dropdowns or accordions.
  • Medium02 - 300ms. Use for greater than medium size objects like side panel or small modals.
  • Slow01 - 450ms. Use for larger objects like big modals or large collapsible content.
  • Slow02 - 600ms. Use for very large objects like page transitions.
Copy

Easing

Use it to determine the velocity of the object's motion:

  • Enter Easing - used for objects that appear on the screen during the enter animation.
  • Exit Easing - used for objects that disappear from the screen during the exit animation.
  • Standard Easing - used for objects that stay present on the screen during enter or exit animations. For example toggle switch.
Copy

Delay

Use it to determine the time it takes for animation or next animation to start. There are three delay values:

  • Short - 100ms.
  • Medium - 150ms.
  • Long - 200ms.
Copy

Common use case examples

Animating list items

Use Transition component in cases when new elements appear or disappear from a screen, like in this case when dismissing list items.

Copy

Code

Copy

Props

NameTypeDefaultDescription
animateOnLoadboolean—Shows enter animation on component mount.
childrenReactNode—Allows to render any component as a child item.
dataHookstring—Applies a data-hook HTML attribute to be used in the tests.
enterAnimationEnterAnimation—Sets a type of animation that happens on enter animation. - fadeIn - javascript { delay?: 'short' | 'medium' | 'long'; duration: | 'fast01' | 'fast02' | 'medium01' | 'medium02' | 'slow01' | 'slow02'; easing?: 'enterEasing' | 'standardEasing'; } - moveIn - javascript { delay?: 'short' | 'medium' | 'long'; direction: | 'topToBottom' | 'bottomToTop' | 'leftToRight' | 'rightToLeft'; distance: string; duration: | 'fast01' | 'fast02' | 'medium01' | 'medium02' | 'slow01' | 'slow02'; easing?: 'enterEasing' | 'standardEasing'; } - expand - javascript { delay?: 'short' | 'medium' | 'long'; direction: | 'topToBottom' | 'bottomToTop' | 'leftToRight' | 'rightToLeft'; duration: | 'fast01' | 'fast02' | 'medium01' | 'medium02' | 'slow01' | 'slow02'; easing?: 'enterEasing' | 'standardEasing'; } - scaleUp - javascript { delay?: 'short' | 'medium' | 'long'; direction: | 'center' | 'top' | 'topEnd' | 'right' | 'bottomEnd' | 'bottom' | 'bottomStart' | 'left' | 'topStart'; duration: | 'fast01' | 'fast02' | 'medium01' | 'medium02' | 'slow01' | 'slow02'; easing?: 'enterEasing' | 'standardEasing'; scale: string; } - swoosh - a preset that quickly fades the content in while it drifts and stretches in from one edge. Pairs with layout components like SidePanel. The motion is skipped when the user prefers reduced motion. javascript { delay?: 'short' | 'medium' | 'long'; direction?: | 'topToBottom' | 'bottomToTop' | 'leftToRight' | 'rightToLeft'; }
exitAnimationExitAnimation—Sets a type of animation that happens on exit animation. - fadeOut - javascript { delay?: 'short' | 'medium' | 'long'; duration: | 'fast01' | 'fast02' | 'medium01' | 'medium02' | 'slow01' | 'slow02'; easing?: 'exitEasing' | 'standardEasing'; } - moveOut - javascript { delay?: 'short' | 'medium' | 'long'; direction: | 'topToBottom' | 'bottomToTop' | 'leftToRight' | 'rightToLeft'; distance: string; duration: | 'fast01' | 'fast02' | 'medium01' | 'medium02' | 'slow01' | 'slow02'; easing?: 'exitEasing' | 'standardEasing' } - collapse - javascript { delay?: 'short' | 'medium' | 'long'; direction: | 'topToBottom' | 'bottomToTop' | 'leftToRight' | 'rightToLeft'; duration: | 'fast01' | 'fast02' | 'medium01' | 'medium02' | 'slow01' | 'slow02'; easing?: 'exitEasing' | 'standardEasing'; } - scaleDown - javascript { delay?: 'short' | 'medium' | 'long'; direction: | 'center' | 'top' | 'topEnd' | 'right' | 'bottomEnd' | 'bottom' | 'bottomStart' | 'left' | 'topStart'; duration: | 'fast01' | 'fast02' | 'medium01' | 'medium02' | 'slow01' | 'slow02'; easing?: 'exitEasing' | 'standardEasing'; scale: string; } - swoosh - a preset that quickly fades the content out while it drifts and squashes back toward one edge. Pass the same direction as the enter preset so the content retreats the way it came in. The motion is skipped when the user prefers reduced motion. javascript { delay?: 'short' | 'medium' | 'long'; direction?: | 'topToBottom' | 'bottomToTop' | 'leftToRight' | 'rightToLeft'; }
mountOnEnterboolean—Lazy-mounts the component. If false, the component mounts immediately. If true, it mounts on the first enter.
onEnd(animationTiming?: AnimationTiming | undefined) => void—Defines a callback function which is called immediately after the animation ends. animationTiming notes if the animation is enter or exit.
onStart(animationTiming?: AnimationTiming | undefined) => void—Defines a callback function which is called immediately after the animation starts. animationTiming notes if the animation is enter or exit.
showboolean—Shows animation when set to true.
unmountOnExitboolean—Unmounts the component after it finishes exiting. If false, the component stays mounted after exit.

Testkit

No testkit for this component — it doesn't expose a unidriver testkit.

Changelog

  • 1.340.0 (2026-10-21) — maintenance release, no component-specific changes
  • 1.339.0 (2026-10-19) — maintenance release, no component-specific changes
  • 1.338.0 (2026-10-15) — maintenance release, no component-specific changes
  • 1.330.3 (2026-09-29) — maintenance release, no component-specific changes
  • 1.330.0 (2026-09-28) — maintenance release, no component-specific changes
  • 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
  • 1.320.1 (2026-09-04) — maintenance release, no component-specific changes
  • 1.318.0 (2026-08-28) — maintenance release, no component-specific changes
  • 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
  • 1.304.0 (2026-07-24) — maintenance release, no component-specific changes
  • 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
  • 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
  • 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
  • 1.188.0 (2025-05-12) — feat: add animation timing parameter to onStart and onEnd callbacks (#14846)
  • 1.165.0 (2025-02-27) — maintenance release, no component-specific changes
  • 1.138.1 (2024-10-30) — maintenance release, no component-specific changes
  • 1.115.0 (2024-07-17) — maintenance release, no component-specific changes
  • 1.108.0 (2024-06-03) — maintenance release, no component-specific changes
  • 1.92.1 (2024-02-05) — maintenance release, no component-specific changes

Last updated: 22 October 2026

Did this help?