useEntryAnimation@xds/core · hooks
Usage
Returns a StyleX style for animating an element on mount. Only animates when the element is dynamically inserted after the initial page paint — elements rendered on page load are not animated. Uses XDS motion tokens (duration, easing) for consistent animation timing. Requires "use client" — does not support SSR.Best practices
|
| Do | Use for conditionally rendered elements like validation messages, toasts, or expanding sections. |
| Do | Spread the returned style into stylex.props() alongside other styles. |
| Don't | Use for elements that should be visible on initial page load — they will not animate. |
Parameters
|
preset | 'slideDown' | 'slideUp' | 'fadeIn' | 'scaleIn' (default: 'slideDown') | Animation preset to apply on mount. |
Returns
|
| entryStyle | StyleXStyles | null | A StyleX style object for the entry animation, or null if the element was rendered on initial page load (no animation needed). |
Import
import {useEntryAnimation} from '@xds/core/hooks'