Announcing use-reduced-motion

Post available in: Français

Everything always starts with an idea

Last week, as I was setting up the dark mode on my personal website, I got motivated to work on a new package for the React community.

” Well, somebody shared a hook to handle the `prefers-color-scheme’ feature in browsers, that’s super handy.”

In just a few minutes, I was able to integrate this great feature without getting in my head. That’s when I thought of that awesome blog post about a new feature for accessibility.

At the time, while reading this article, I found out that some users may feel uncomfortable consulting web pages that “wiggle”. Indeed, elements of a page that move, zoom or change colors can greatly disturb the use and understanding of the content of our pages. This may not be the case for you, but many users are in this situation.

In order to allow you to better understand the problem, I suggest a small experiment with a very short video. Focus on the people dressed in white and try to count the number of passes.

Do you understand now?

The “superb onboarding animation” may be very beautiful, but it is very disturbing for some of your users. They find themselves in the same situation as you do with this video. The moving elements make it difficult to capture all the information you want to convey.

Fortunately, OS and browsers have become aware of accessibility issues and now provide tools.

It is therefore our responsibility today to integrate these solutions to avoid putting some of our users in a situation of handicap.

A media query allows you to stop your animations for users who wish to do so.

  If the user has expressed their preference for
  reduced motion, then don't use animations on buttons.
@media (prefers-reduced-motion: reduce) {
  button {
    animation: none;

The support for this feature is even very correct.

Support for the prefers-reduced-motion feature in May 2020

Here is a video demo of how this feature works, taken from the article quoted above.

Where is the package and how to use it?

It’s very nice this media query but in some cases, the animations I use on my sites are managed by JavaScript. Fortunately, we have solutions to track the use of the media query in the browser.

To make them easier to use with React, I’ve integrated them into a Hook in the way of use-dark-mode.

To install it in your project, nothing could be simpler:

npm install use-reduced-motion
# or
yarn add use-reduced-motion

Then you just have to use it in one of your components:

import React from 'react'
import { useReducedMotion } from 'use-reduced-motion'
import { AnimatedDiv } from '../somewhere'

export const MyExampleComponent = () => {
  const prefersReducedMotion = useReducedMotion()
  return <AnimatedDiv pause={prefersReducedMotion} />

I invite you to test here with your browser/OS, the following animation will stop automatically.

Feel free to share this article if you liked it, any contribution to the package is welcome.

Image credit unDraw

Written by Antoine Caron who lives and works in Lyon (France) building useful things at Bedrock. You should follow him on Twitter. Take a look at my friends websites. You could also take a look at the conferences I gave. If you want to see my professional background, my resume is available here.

If you like some content of this blog, or it has helped you, please consider donating to the Abbé Pierre Foundation which I personally support.
"We are only ever happy in the happiness we give. To give is to receive."