feat: implement iOS 26 minimize behavior

Author: okwasniewski

apps/example/ios/Podfile.lock

@@ -1180,7 +1180,7 @@ PODS:
     - React-jsiexecutor
     - React-RCTFBReactNativeSpec
     - ReactCommon/turbomodule/core
-  - react-native-bottom-tabs (0.9.1):
+  - react-native-bottom-tabs (0.9.2):
     - DoubleConversion
     - glog
     - RCT-Folly (= 2024.11.18.00)
@@ -1931,7 +1931,7 @@ SPEC CHECKSUMS:
   React-logger: 1935d6e6461e9c8be4c87af56c56a4876021171e
   React-Mapbuffer: 212171f037e3b22e6c2df839aa826806da480b85
   React-microtasksnativemodule: a0ffd165c39251512d8cf51e9e8f5719dabc38b6
-  react-native-bottom-tabs: 7c7ee94435e518759b414e89068956096a1adec7
+  react-native-bottom-tabs: 6ee03990297f7e37f5c1dd6f5259cee851733d4f
   react-native-safe-area-context: e54b360402f089600c2fb0d825d1d3d918b99e15
   React-nativeconfig: cb207ebba7cafce30657c7ad9f1587a8f32e4564
   React-NativeModulesApple: 76a5d35322908fbc88871e6dd20433bea2b8b2db

apps/example/src/Examples/SFSymbols.tsx

@@ -47,6 +47,7 @@ export default function SFSymbols() {
   return (
     <TabView
       sidebarAdaptable
+      minimizeBehavior="onScrollDown"
       navigationState={{ index, routes }}
       onIndexChange={setIndex}
       renderScene={renderScene}

packages/react-native-bottom-tabs/ios/Fabric/RCTTabViewComponentView.mm

@@ -130,6 +130,10 @@ - (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &
   if (oldViewProps.sidebarAdaptable != newViewProps.sidebarAdaptable) {
     _tabViewProvider.sidebarAdaptable = newViewProps.sidebarAdaptable;
   }
+  
+  if (oldViewProps.minimizeBehavior != newViewProps.minimizeBehavior) {
+    _tabViewProvider.minimizeBehavior = RCTNSStringFromString(newViewProps.minimizeBehavior);
+  }
 
   if (oldViewProps.disablePageAnimations != newViewProps.disablePageAnimations) {
     _tabViewProvider.disablePageAnimations = newViewProps.disablePageAnimations;

packages/react-native-bottom-tabs/ios/RCTTabViewViewManager.mm

@@ -29,6 +29,7 @@ @implementation RCTTabView
 RCT_EXPORT_VIEW_PROPERTY(onNativeLayout, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(selectedPage, NSString)
 RCT_EXPORT_VIEW_PROPERTY(tabViewStyle, NSString)
+RCT_EXPORT_VIEW_PROPERTY(minimizeBehavior, NSString)
 RCT_EXPORT_VIEW_PROPERTY(icons, NSArray<RCTImageSource *>);
 RCT_EXPORT_VIEW_PROPERTY(sidebarAdaptable, BOOL)
 RCT_EXPORT_VIEW_PROPERTY(labeled, BOOL)

packages/react-native-bottom-tabs/ios/TabViewImpl.swift

@@ -28,6 +28,7 @@ struct TabViewImpl: View {
         onLayout(size)
       }
     }
+    .tabBarMinimizeBehavior(props.minimizeBehavior)
 #if !os(tvOS) && !os(macOS) && !os(visionOS)
     .onTabItemEvent { index, isLongPress in
       let item = props.filteredItems[safe: index]
@@ -333,6 +334,19 @@ extension View {
     }
   }
 
+  @ViewBuilder
+  func tabBarMinimizeBehavior(_ behavior: MinimizeBehavior?) -> some View {
+    if #available(iOS 26.0, *) {
+      if let behavior {
+        self.tabBarMinimizeBehavior(behavior.convert())
+      } else {
+        self
+      }
+    } else {
+      self
+    }
+  }
+
   @ViewBuilder
   func hideTabBar(_ flag: Bool) -> some View {
 #if !os(macOS)

packages/react-native-bottom-tabs/ios/TabViewProps.swift

@@ -1,5 +1,26 @@
 import SwiftUI
 
+internal enum MinimizeBehavior: String {
+  case automatic
+  case never
+  case onScrollUp
+  case onScrollDown
+
+  @available(iOS 26.0, *)
+  func convert() -> TabBarMinimizeBehavior {
+    switch self {
+    case .automatic:
+      return .automatic
+    case .never:
+      return .never
+    case .onScrollUp:
+      return .onScrollUp
+    case .onScrollDown:
+      return .onScrollDown
+    }
+  }
+}
+
 /**
  Props that component accepts. SwiftUI view gets re-rendered when ObservableObject changes.
  */
@@ -10,6 +31,7 @@ class TabViewProps: ObservableObject {
   @Published var icons: [Int: PlatformImage] = [:]
   @Published var sidebarAdaptable: Bool?
   @Published var labeled: Bool = false
+  @Published var minimizeBehavior: MinimizeBehavior?
   @Published var scrollEdgeAppearance: String?
   @Published var barTintColor: PlatformColor?
   @Published var activeTintColor: PlatformColor?

packages/react-native-bottom-tabs/ios/TabViewProvider.swift

@@ -102,6 +102,12 @@ public final class TabInfo: NSObject {
     }
   }
 
+  @objc public var minimizeBehavior: NSString? {
+    didSet {
+      props.minimizeBehavior = MinimizeBehavior(rawValue: minimizeBehavior as? String ?? "")
+    }
+  }
+
   @objc public var translucent: Bool = true {
     didSet {
       props.translucent = translucent

packages/react-native-bottom-tabs/src/TabView.tsx

@@ -54,6 +54,11 @@ interface Props<Route extends BaseRoute> {
    * Describes the appearance attributes for the tabBar to use when an observable scroll view is scrolled to the bottom. (iOS only)
    */
   scrollEdgeAppearance?: 'default' | 'opaque' | 'transparent';
+
+  /**
+   * Behavior for minimizing the tab bar. (iOS 26+)
+   */
+  minimizeBehavior?: 'automatic' | 'onScrollDown' | 'onScrollUp' | 'never';
   /**
    * Active tab color.
    */

packages/react-native-bottom-tabs/src/TabViewNativeComponent.ts

@@ -52,6 +52,7 @@ export interface TabViewProps extends ViewProps {
   disablePageAnimations?: boolean;
   activeIndicatorColor?: ColorValue;
   hapticFeedbackEnabled?: boolean;
+  minimizeBehavior?: string;
   fontFamily?: string;
   fontWeight?: string;
   fontSize?: Int32;