API Reference / @gtkx/animated / useReducedMotion

Function: useReducedMotion()

useReducedMotion(): boolean | null

Defined in: packages/animated/src/reduced-motion.ts:88

Tracks GTK's motion preferences and updates when they change.

Returns

boolean | null

true when animations are disabled or GTK 4.22+ requests reduced motion, false otherwise, or null before a display opens.

Remarks

gtk-enable-animations: false makes springs jump to their targets. GTKX sets React Spring's Globals.skipAnimation only when that setting changes, so an application can set it for its own preference. gtk-interface-reduced-motion leaves springs running for components to adapt; it also drives GTK's prefers-reduced-motion media query.