Skip to content

Update accessibility-best-practices-for-your-project.md#3683

Merged
ahpook merged 4 commits into
github:mainfrom
ChasBelov:patch-1
Jun 13, 2026
Merged

Update accessibility-best-practices-for-your-project.md#3683
ahpook merged 4 commits into
github:mainfrom
ChasBelov:patch-1

Conversation

@ChasBelov

Copy link
Copy Markdown
Contributor

Add comments regarding "reduce motion" to Motion and Animation section

  • Have you followed the contributing guidelines?
  • Have you explained what your changes do, and why they add value to the Guides?

Please note: we will close your PR without comment if you do not check the boxes above and provide ALL requested information.


While there is a mention in the checklist of prefers reduced motion, it was not mentioned under Motion and Animation. I believe additional detail belongs there. In particular, there is misunderstanding around the word "reduce." That is an artifact of history because Apple got there first. Non-Apple operating systems use setting wording that imply animation on or off. However, because it is a toggle in all systems, there is no way to know whether the user would prefer minimal animation or absolutely no animation.

I've added brief (I hope) text addressing this in the Motion and Animation section.

Add comments regarding "reduce motion" to Motion and Animation section
@ChasBelov ChasBelov requested a review from a team as a code owner June 5, 2026 18:52

@patrzyszco78-png patrzyszco78-png left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

G

@ahpook

ahpook commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

I understand your point but I don't think the text you provided clarifies the original statement. Could you reword the original sentence in a way that incorporates the differences you're trying to capture? How about simply:

"Avoid unnecessary animation if the operating system indicates the user has requested reduced or zero motion"

Updated Motion and Animation to clarify reduce motion/no motion.
@ChasBelov

ChasBelov commented Jun 13, 2026

Copy link
Copy Markdown
Contributor Author

I understand your point but I don't think the text you provided clarifies the original statement. Could you reword the original sentence in a way that incorporates the differences you're trying to capture? How about simply:

"Avoid unnecessary animation if the operating system indicates the user has requested reduced or zero motion"

Updated, thank you.

Comment thread _articles/accessibility-best-practices-for-your-project.md Outdated

@ahpook ahpook left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left off the editorializing but will merge and deploy this.

@ahpook ahpook enabled auto-merge June 13, 2026 07:29
@ahpook ahpook disabled auto-merge June 13, 2026 07:30
@ahpook ahpook merged commit bf3fa98 into github:main Jun 13, 2026
6 of 7 checks passed
babarbaby0-design

This comment was marked as spam.

@ChasBelov

Copy link
Copy Markdown
Contributor Author

Thank you for the merge. Just for the record, I had included the details regarding the differences between systems because often, when discussions of this setting come up, the implemented name for the setting in CSS "prefers-reduced-motion" is taken by some commenters as not meaning a request to remove all animation because of the name, when it's only what Apple, who got there first, called it (but didn't provide a corresponding setting for no animation).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants