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.mdindex 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 Astryxshows, 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; acoast 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 completeimmediately, 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 questionsNone.