Skip to main content
Version: 3.x

ReducedMotionConfig

ReducedMotionConfig component let's you change behavior in response to the device's reduced motion accessibility setting. By default it disables all animation when the reduced motion is enabled on a device. You can adjust it for your specific use case. You can learn more about Accessibility and useReducedMotion in Reanimated.

caution

The new configuration will be applied globally across the entire application.

Reference

import { ReducedMotionConfig, ReduceMotion } from 'react-native-reanimated';

function App() {
return (
// ...
<ReducedMotionConfig mode={ReduceMotion.Never} />
// ...
);
}

Type definitions

interface ReducedMotionConfigProps {
mode: ReduceMotion;
}

enum ReduceMotion {
System = 'system',
Always = 'always',
Never = 'never',
}

Arguments

mode

A parameter that determines how animations should behave in response to the device's reduce motion accessibility setting.

  • ReduceMotion.System - This value adjusts the animation behavior based on whether the reduced motion accessibility setting is activated on the device. When enabled, the animation is disabled; otherwise, it remains active.
  • ReduceMotion.Always - With this setting, the animation is consistently disabled, regardless of the device's accessibility configuration.
  • ReduceMotion.Never - This option ensures that the animation remains enabled at all times.

Example

Loading...

Platform compatibility

AndroidiOSWeb