Skip to content

Liquid Glass support

Latest
Latest

Choose a tag to compare

View all tags
@wtmoose wtmoose released this 28 Sep 04:13
3.0.0
e311132
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Breaking Changes

  • Minimum deployment target raised to iOS 18. iOS 17 is no longer supported.
  • HeaderContext converted from a struct to an @Observable class to address performance issues related to SwiftData queries. The observable class shields content views from re-performing queries and re-evaluating body on every frame while scrolling. If you stored HeaderContext (or its typealiases MaterialTabsHeaderContext / StickyHeaderContext) by value, you will need to update to reference semantics.
  • #19 MaterialTabsScroll joint scroll position API replaced with iOS 18 ScrollPosition. The old scrollAnchor parameter is replaced by optional scrollPosition and anchor bindings for joint scroll position manipulation between the library and client code.

Improvements

  • Add .materialTabsScrollEdgeEffect() on iOS 26 and later. Transparent headers and tab bars can extend the navigation bar's native scroll-edge blur, including collapsible headers, without implementing custom blur values or transitions.

  • Document Liquid Glass setup and why opaque header backgrounds cover the scrolling content instead of being blurred by the modifier.

  • Add shared Core and Extended Xcode test plans with scroll-position, header-continuity, and tab-state regression checks. Validation runs inside XCTest; no command-line post-processing is required.

  • #25 MaterialTabBar now supports an alignment parameter (.leading, .center, .trailing) for controlling horizontal positioning of self-sized tabs when fillAvailableSpace is false.

  • #25 New MaterialAccessoryTabBar component for adding optional leading and trailing accessory views alongside tab selectors. Accessories scroll horizontally with the tabs.

  • #25 TabBarModel and HeaderModel are now public, enabling fully custom tab bar implementations via the environment.

Fixes

  • Preserve tab content state and scroll position when returning to tabs on iOS 27.
  • Correct incoming-tab scroll alignment with the shared header, including taps to previously unvisited tabs.
  • Preserve header and scroll-position continuity when switching tabs during deceleration.
Assets 2
Loading