Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

design(reduced-motion): an in-place value change applies at once on any pointer (DR2) (#8645)

Cindy Zhang1d66a581f978
diff --git a/docs/design/reduced-motion.md b/docs/design/reduced-motion.md
index 9787d2914d..509499aac7 100644
--- a/docs/design/reduced-motion.md
+++ b/docs/design/reduced-motion.md
@@ -31,7 +31,8 @@ deciding_specs: []
A person who asks their device to reduce motion still sees every change Astryx
shows, with no travel, scaling, or springing. On a touch screen a change
-cross-fades, as iOS does with Reduce Motion and Prefer Cross-Fade; with a mouse,
+cross-fades, as iOS does with Reduce Motion and Prefer Cross-Fade, except an
+in-place value change, which applies at once; with a mouse,
trackpad, or keyboard the change is immediate.
## Design principles
@@ -53,11 +54,11 @@ trackpad, or keyboard the change is immediate.
## State representation
-| State | Required representation | Allowed variation |
-| --------------------------------- | ----------------------------------------------------------- | -------------------------- |
-| reduced motion, coarse pointer | Opacity-only cross-fade of 200 ms or less (DR2) | A shorter cross-fade |
-| reduced motion, any other pointer | Immediate change (DR3), except a touch drag's release (DR2) | None |
-| no reduced-motion preference | Outside this record | Component and theme motion |
+| State | Required representation | Allowed variation |
+| --------------------------------- | ----------------------------------------------------------------------------------------------- | -------------------------- |
+| reduced motion, coarse pointer | Opacity-only cross-fade of 200 ms or less (DR2); an in-place value change applies at once (DR2) | A shorter cross-fade |
+| reduced motion, any other pointer | Immediate change (DR3), except a touch drag's release (DR2) | None |
+| no reduced-motion preference | Outside this record | Component and theme motion |
## Responsive and input behavior
@@ -71,7 +72,9 @@ trackpad, or keyboard the change is immediate.
release, such as snapping to a detent, dismissing, or paging to a target,
still cross-fades. Native scrolling is the browser's and is untouched; a
coast Astryx animates itself after a throw behaves like native momentum
- under Reduce Motion.
+ under Reduce Motion. An in-place value change, such as a progress fill's length or
+ another continuous value, does not cross-fade: under reduced motion it
+ applies at once on any pointer, with no added element (DEC-3).
- **DR3 — Fine-pointer presentations change at once.** Under reduced motion,
every other DR1 transition, when the primary pointer is not coarse, MUST complete
immediately, with no animated property.
@@ -117,12 +120,13 @@ No normative assets are included.
### Verification
-| Contract | Verification | Representative states | Failure signal |
-| ------------ | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
-| DR1, DR2 | Real-browser computed animations under reduced motion, coarse pointer | Layer entrance and exit (Tooltip, Popover, menu); Dialog; modal BottomSheet; a presentation switch | An animated transform, size, or position; a spring; a property other than opacity; over 200 ms; a change with no cross-fade |
-| DR2 momentum | Real-browser computed animations under reduced motion after a touch throw | A flick that coasts and settles at an edge; a release that snaps to a detent, dismisses, or pages to a target | A coast replaced by a cross-fade or stopped at release; a snap, dismissal, or page that travels instead of cross-fading |
-| DR1, DR3 | Real-browser computed animations under reduced motion, fine pointer | The same components | Any animated property, or a frame where the change is partly applied |
-| DR4 | Component prop and theme review plus the browser checks above | A component with a motion prop or theme motion value set | A prop or theme value that restores travel or a longer animation under reduced motion |
+| Contract | Verification | Representative states | Failure signal |
+| ------------ | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| DR1, DR2 | Real-browser computed animations under reduced motion, coarse pointer | Layer entrance and exit (Tooltip, Popover, menu); Dialog; modal BottomSheet; a presentation switch | An animated transform, size, or position; a spring; a property other than opacity; over 200 ms; a change with no cross-fade |
+| DR2 momentum | Real-browser computed animations under reduced motion after a touch throw | A flick that coasts and settles at an edge; a release that snaps to a detent, dismisses, or pages to a target | A coast replaced by a cross-fade or stopped at release; a snap, dismissal, or page that travels instead of cross-fading |
+| DR2 values | Real-browser computed animations under reduced motion, coarse and fine pointer | A determinate ProgressBar's fill and another continuous value changing in place | A value that animates, cross-fades, or adds an element under reduced motion fails |
+| DR1, DR3 | Real-browser computed animations under reduced motion, fine pointer | The same components | Any animated property, or a frame where the change is partly applied |
+| DR4 | Component prop and theme review plus the browser checks above | A component with a motion prop or theme motion value set | A prop or theme value that restores travel or a longer animation under reduced motion |
## Decision log
@@ -153,6 +157,17 @@ component starts, still cross-fade under DR2.
Rejected: cross-fading or stopping momentum at release.
+### DEC-3 — An in-place value change applies at once
+
+**Reference:** `design:reduced-motion/DEC-3`
+**Decider:** `cixzhang`, `2026-10-26`
+
+A progress fill's length and similar continuous values change where they are;
+cross-fading two lengths would need a second element and still show motion.
+Under reduced motion they take the new value at once on any pointer.
+
+Rejected: a cross-fade between the old and new value on a touch screen.
+
## Open questions
None.