Skip to content

Document that a real SF Symbol name draws as itself on iOS - #614

Open
wojt-janowski wants to merge 2 commits into
NativePHP:mainfrom
wojt-janowski:docs/ios-sf-symbol-names
Open

wojt-janowski wants to merge 2 commits into
NativePHP:mainfrom
wojt-janowski:docs/ios-sf-symbol-names

Conversation

@wojt-janowski

@wojt-janowski wojt-janowski commented Nov 15, 2026 •

Copy link
Copy Markdown
Contributor

Documents NativePHP/mobile-air#695, which fixes NativePHP/mobile-air#650: on iOS, an icon name that is already an SF Symbol (heart, phone, star, …) now draws that symbol as written instead of going through the alias table. Merge it with or after #695.

  • How names resolve: the first tier now says that on iOS, a name that is already an SF Symbol name is used as written, as well as a dotted name.
  • iOS (SF Symbols): shared names like heart and star now draw the outline symbol. To get the filled one, ask for heart.fill / Ios::HeartFill or use an alias such as favorite. Android draws the filled Material icon for the same shared name, so there's an example that gives each platform its own name.
  • Icon name reference: replaces "All icons listed here are manually mapped and guaranteed to work consistently across iOS and Android". It lists the names that now draw outline on iOS and filled on Android. It also lists the names that draw a different symbol on each platform (forward, info, mail, smartphone, speaker, location) and the alias to use for matching icons.

The three changed spots carry a changed="4.9" badge, for the release #695 is expected to land in.

Testing

  • php artisan test --filter=Documentation: 8 passed.
  • Rendered the page locally and checked the three changed sections, the new code example and the anchor link.

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.

iOS: real SF Symbol names like phone, heart, star and map draw as their .fill versions, so outline icons can't be used

1 participant