Skip to content

Document morph transitions for mobile v4 - #569

Merged
simonhamp merged 1 commit into
mainfrom
docs/morph-transitions
Oct 23, 2026
Merged

simonhamp merged 1 commit into
mainfrom
docs/morph-transitions

Conversation

@simonhamp

Copy link
Copy Markdown
Member

Docs for the shared-element transition in NativePHP/mobile-air#372. Don't merge until that PR is merged and released.

What's in it:

  • A new "Morphing elements between screens" section on the routing page. It covers giving an element the same ref on two screens, @navigate.morph and Transition::Morph, and the morph, morph-duration and morph-easing attributes.
  • Transition::Morph and the morph modifier added to the existing transition lists.
  • A link to the new section from the Gestures & Animation page.
  • A note on the testing page that a ref now shows up for UI drivers like Maestro and XCUITest, and that repeating one across screens can make it morph.

Things to check:

  • Everything new carries a 4.7 badge.
  • The "Native chrome" subsection says that pushes between two screens with a native top bar, and tab switches, don't morph. That's true on both platforms today, because the platform's own navigation animates those and the morph never runs. If that changes before release, the subsection should go.
  • There's no Jump badge. The morph is native code, so it won't show in Jump until Jump is rebuilt. I wasn't sure which Jump version to put.

🤖 Generated with Claude Code

Adds a "Morphing elements between screens" section to the routing page
for `@navigate.morph` and `Transition::Morph`, from NativePHP/mobile-air#372.
It covers matching elements by `ref`, the morph, morph-duration and
morph-easing attributes, which elements morph, and the native chrome
case where nothing does.

Also lists the new transition with the existing ones, points to it from
Gestures & Animation, and notes on the testing page that a ref now
reaches UI drivers and can make an element morph.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@simonhamp
simonhamp merged commit 687e413 into main Oct 23, 2026
2 of 3 checks passed
@simonhamp
simonhamp deleted the docs/morph-transitions branch October 23, 2026 11:43
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.

1 participant