README.md

SwiftUI Issues, Limitations & Unknowns

With Apple's documentation for SwiftUI being limited, I wanted to create a central resource of all bugs, issues and limitations with SwiftUI.

Current Issues

• Environment/observed objects lose data on list view change. This problem appear in case when parent view updated with same data in terms of hash. The bug is not appearing when the parent view updated with different data.
  • 🔨 Example
  • ✍🏻 Explanation
  • 📝 FB7411430
• Tab view resets view and navigation stack
  • 🔨 Example
  • ↪️ Workaround
  • 📝 FB7301114
• Modal views/sheets don't automatically have environment data
  • 🔨 Example
• Context menu not showing on a custom view with resizable or geometry reader
  • 🔨 Example
  • 📝 FB7416520
• Multiple buttons in a list row causes both buttons to be actioned upon when tapped
  • 🔨 Example
  • ↪️ Workaround
  • 📝 FB7416322
• 'Tried to pop to a view controller that doesn't exist' crash
  • 🔨 Example
  • ↪️ Workaround
• .minimumScaleFactor() is broken in WatchOS app: instead of scaling down, it just set to minimum
  • 📝 FB7408679
  • 🔨 Example
• List insets change padding within a list view when changing state
• List doesn't update update a list view using an array and ForEach()
  • 🔨 Example
• List crashes when TabView tab changes during a scroll
  • 🔨 Example

Limitations/Unknowns

• No SwiftUI equivalent to UICollectionView
• Scrollview with HStack and items have poor performance for large data sets (all child views are loaded on init).
  • 📝 FB7216618
• Unable to change navigation appearance for a single view
  • 📝 FB7310681
• Unable to easily support deep linking for universal links or notifications
  • 📝 FB7408717
• Unable to use a UISearchController with a SwiftUI view
  • 🔨 Example
  • 📝 FB7416329
• Unable to remove a list item background altogether for one cell
  • 📝 FB7371374
• Unable to know when view becomes active again (equivalent to viewDidAppear)
• Unable to change status bar colour
  • ↪️ Workaround
  • 📝 FB7400803
• @FetchRequest property wrapper doesn't support dynamic variable predicates
  • ↪️ Workaround
  • 📝 FB7207999
• List doesn't support section index
  • 📝 FB7441706
• Horizontal ScrollView inside a vertical ScrollView captures vertical scrolling gesture on macOS
  • 📝 FB7673707
  • 🔨 Example

Resolved

• Unable to remove or customise list separators
  • 📝 FB7108559
  • ✅ iOS 15: hide list separators for certain edges with .listRowSeparator, and change tint color with .listRowSeparatorTint

Please feel free to PR and submit examples, workarounds and/or fixes so I can keep this up to date.