Foundationwhole
Shared Axis Z
Depth shared-axis — new scales into focus as the old recedes blurred.
Installation
Run the following command:
pnpmdlx shadcn@latest add https://mutype.dev/r/shared-axis-z.jsonProps
| Prop | Type | Default | Description |
|---|---|---|---|
| spec | AnimationSpec | — | Animation spec object (imported from components/mutype/specs/<id>). |
| text | string | — | The text to animate. |
| as | "span" | "div" | "h1"–"h4" | "p" | "span" | The HTML element to render. |
| triggerKey | string | number | — | Re-runs the animation when the value changes. |
| duration_multiplier | number | 1 | Scales duration_ms and stagger_ms uniformly. >1 slower, <1 faster. |
| y_travel_multiplier | number | 1 | Multiplier on y_px values; useful to dampen lift on small text. |
| forceReducedMotion | boolean | false | Forces the reduced-motion fallback even when the user has not opted in (testing). |
| onFinished | () => void | — | Fires once when the enter phase completes (not on cancel). |
| className | string | — | Tailwind / CSS class names. Forwarded to the host element. |
Usage notes
Use when the new screen sits at a different focus depth — drilling into a detail view, opening a focused editor, or any context shift where direction (X/Y) does not apply. Keep blur ≤ 3px to avoid Safari-side composite cost. Pair with shared-axis-x and shared-axis-y so the same easing curve carries across the navigation system.
Inspired by Material Design shared axis (Z); focus shifts and context depth..
