Skip to content

Document mobile 4.8.0 - #610

Open
shanerbaner82 wants to merge 1 commit into
mainfrom
docs/mobile-4.8.0
Open

shanerbaner82 wants to merge 1 commit into
mainfrom
docs/mobile-4.8.0

Conversation

@shanerbaner82

Copy link
Copy Markdown
Contributor

Docs for the NativePHP for Mobile 4.8.0 release. Every API here was checked against the 4.8.0 tag of mobile-air.

What's covered

  • Native chrome by default (mobile-air#678). New "Native chrome" section in Layouts: usesNativeChrome() now defaults to true, the return false opt-out is temporary, and $hidesNavBar / $hidesTabBar mark the bar hidden instead of dropping it. "How chrome wraps the screen" now says the Column tree is the opt-out path. The Top Bar hiding section is updated to match.
  • Handlers that set properties (mobile-air#677). New "Handlers" section in the EDGE introduction covering $prop = <literal> and $prop = !$prop: literals only, #[Locked] is respected, the updating/updated hooks fire, and InvalidHandlerException is thrown in debug and logged otherwise. Bottom Sheet and Modal get a short note linking to it, and Nested Components shows it on a child's event binding.
  • #[Memo] (mobile-air#675). New section in Nested Components: opt-in, what triggers a re-render, and the stale-output caveat (time, session, config, DB, #[Computed] / #[Poll] values).
  • Transition::SlideToBottom and the transition argument (mobile-air#452). Routing documents the optional transition argument on navigate() / back() / replace() and the new case, and notes it's iOS-only in 4.8 (Android parity is in mobile-air#683). Top Bar documents the transition attribute on <native:top-bar-action url="...">.
  • AppBackgrounded / AppForegrounded (mobile-air#672). New section in Lifecycle Hooks, plus rows in the "Package events that broadcast globally" table.
  • Upgrade guide: a new "Upgrading To 4.8 From 4.7" section (native chrome default, debug handler exceptions, and native:install --force).

New APIs carry <x-docs.version-badge since="4.8" />. The Layouts native chrome section uses changed="4.8".

Notes

  • With #677 shipped, the Jump-only note proposed in docs(mobile/4): note inline handlers only work in Jump #557 for the Modal and Bottom Sheet examples is no longer accurate for 4.8+.
  • When #683 is released, the Android caveat under Custom transitions can be removed.
  • I couldn't run the PHP test suite locally, so CI will be the first render check.

This branch has not been deployed

No deployments
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