[BREAKING] Top bar options changes (#4040)

* Removed topBar.transparent and added transparent color support for topBar.background.color

* fix unit tests

docs/docs/options-migration.md

 
 ```js
 topBar: {
-  transparent: true
+  background: {
+    color: 'transparent'
+  }
 }  
 ```
 
 
 ```js
 topBar: {
-  translucent: true
+  background: {
+    translucent: true
+  }
 }
 ```
 
 
 ```js
 topBar: {
-  blur: true
+  background: {
+    blur: true
+  }
 }  
 ```
 

docs/docs/styling.md

   rootBackgroundImage: require('rootBackground.png'),
   topBar: {
     barStyle: 'default' | 'black',
-    translucent: true,
-    transparent: false,
+    background: {
+      translucent: true,
+      blur: false
+    }
     noBorder: false,
-    blur: false,
     backButton: {
       title: 'Back',
       showTitle: false

lib/ios/RNNBackgroundOptions.h

 @interface RNNBackgroundOptions : RNNOptions
 
 @property (nonatomic, strong) NSNumber* color;
+@property (nonatomic, strong) NSNumber* translucent;
+@property (nonatomic, strong) NSNumber* blur;
 @property (nonatomic, strong) RNNComponentOptions* component;
 @property (nonatomic, strong) NSNumber* clipToBounds; 
 

lib/ios/RNNBackgroundOptions.m

 #import "RNNBackgroundOptions.h"
 
+extern const NSInteger BLUR_TOPBAR_TAG;
+const NSInteger TOP_BAR_TRANSPARENT_TAG = 78264803;
+
+@interface RNNBackgroundOptions()
+
+@property (nonatomic, strong) NSMutableDictionary* originalTopBarImages;
+
+@end
+
 @implementation RNNBackgroundOptions
 
 - (void)applyOnNavigationController:(UINavigationController *)navigationController {
+	if (self.translucent) {
+		navigationController.navigationBar.translucent = [self.translucent boolValue];
+	} else {
+		navigationController.navigationBar.translucent = NO;
+	}
+	
+	if ([self.blur boolValue]) {
+		if (![navigationController.navigationBar viewWithTag:BLUR_TOPBAR_TAG]) {
+
+			[navigationController.navigationBar setBackgroundImage:[UIImage new] forBarMetrics:UIBarMetricsDefault];
+			navigationController.navigationBar.shadowImage = [UIImage new];
+			UIVisualEffectView *blur = [[UIVisualEffectView alloc] initWithEffect:[UIBlurEffect effectWithStyle:UIBlurEffectStyleLight]];
+			CGRect statusBarFrame = [[UIApplication sharedApplication] statusBarFrame];
+			blur.frame = CGRectMake(0, -1 * statusBarFrame.size.height, navigationController.navigationBar.frame.size.width, navigationController.navigationBar.frame.size.height + statusBarFrame.size.height);
+			blur.userInteractionEnabled = NO;
+			blur.tag = BLUR_TOPBAR_TAG;
+			[navigationController.navigationBar insertSubview:blur atIndex:0];
+			[navigationController.navigationBar sendSubviewToBack:blur];
+		}
+	} else {
+		UIView *blur = [navigationController.navigationBar viewWithTag:BLUR_TOPBAR_TAG];
+		if (blur) {
+			[navigationController.navigationBar setBackgroundImage: nil forBarMetrics:UIBarMetricsDefault];
+			navigationController.navigationBar.shadowImage = nil;
+			[blur removeFromSuperview];
+		}
+	}
+	
 	if (self.color && ![self.color isKindOfClass:[NSNull class]]) {
 		UIColor* backgroundColor = [RCTConvert UIColor:self.color];
-		navigationController.navigationBar.barTintColor = backgroundColor;
+
+		CGFloat bgColorAlpha = CGColorGetAlpha(backgroundColor.CGColor);
+
+		if (bgColorAlpha == 0.0) {
+			if (![navigationController.navigationBar viewWithTag:TOP_BAR_TRANSPARENT_TAG]){
+				[self storeOriginalTopBarImages:navigationController];
+				UIView *transparentView = [[UIView alloc] initWithFrame:CGRectZero];
+				transparentView.backgroundColor = [UIColor clearColor];
+				transparentView.tag = TOP_BAR_TRANSPARENT_TAG;
+				[navigationController.navigationBar insertSubview:transparentView atIndex:0];
+			}
+			navigationController.navigationBar.translucent = YES;
+			[navigationController.navigationBar setBackgroundColor:[UIColor clearColor]];
+			navigationController.navigationBar.shadowImage = [UIImage new];
+			[navigationController.navigationBar setBackgroundImage:[UIImage new] forBarMetrics:UIBarMetricsDefault];
+		} else {
+			navigationController.navigationBar.barTintColor = backgroundColor;
+			UIView *transparentView = [navigationController.navigationBar viewWithTag:TOP_BAR_TRANSPARENT_TAG];
+			if (transparentView){
+				[transparentView removeFromSuperview];
+				[navigationController.navigationBar setBackgroundImage:self.originalTopBarImages[@"backgroundImage"] forBarMetrics:UIBarMetricsDefault];
+				navigationController.navigationBar.shadowImage = self.originalTopBarImages[@"shadowImage"];
+				self.originalTopBarImages = nil;
+			}
+		}
+	} else {
+		UIView *transparentView = [navigationController.navigationBar viewWithTag:TOP_BAR_TRANSPARENT_TAG];
+		if (transparentView){
+			[transparentView removeFromSuperview];
+			[navigationController.navigationBar setBackgroundImage:self.originalTopBarImages[@"backgroundImage"] forBarMetrics:UIBarMetricsDefault];
+			navigationController.navigationBar.shadowImage = self.originalTopBarImages[@"shadowImage"];
+			self.originalTopBarImages = nil;
+		}
+	}
+}
+
+- (void)storeOriginalTopBarImages:(UINavigationController *)navigationController {
+	NSMutableDictionary *originalTopBarImages = [@{} mutableCopy];
+	UIImage *bgImage = [navigationController.navigationBar backgroundImageForBarMetrics:UIBarMetricsDefault];
+	if (bgImage != nil) {
+		originalTopBarImages[@"backgroundImage"] = bgImage;
+	}
+	UIImage *shadowImage = navigationController.navigationBar.shadowImage;
+	if (shadowImage != nil) {
+		originalTopBarImages[@"shadowImage"] = shadowImage;
 	}
+	self.originalTopBarImages = originalTopBarImages;
 }
 
 @end

lib/ios/RNNTopBarOptions.h

 @property (nonatomic, strong) NSNumber* leftButtonDisabledColor;
 @property (nonatomic, strong) NSNumber* rightButtonDisabledColor;
 @property (nonatomic, strong) NSString* barStyle;
-@property (nonatomic, strong) NSNumber* translucent;
-@property (nonatomic, strong) NSNumber* transparent;
 @property (nonatomic, strong) NSNumber* drawBehind;
 @property (nonatomic, strong) NSNumber* noBorder;
-@property (nonatomic, strong) NSNumber* blur;
 @property (nonatomic, strong) NSNumber* animate;
 @property (nonatomic, strong) NSString* testID;
 @property (nonatomic, strong) RNNLargeTitleOptions* largeTitle;

lib/ios/RNNTopBarOptions.m

 #import "RNNNavigationButtons.h"
 #import "RNNCustomTitleView.h"
 
-extern const NSInteger BLUR_TOPBAR_TAG;
-const NSInteger TOP_BAR_TRANSPARENT_TAG = 78264803;
-
-
 @interface RNNTopBarOptions ()
 
-@property (nonatomic, strong) NSMutableDictionary* originalTopBarImages;
 @property (nonatomic, strong) RNNNavigationButtons* navigationButtons;
 
 @end
 }
 
 - (void)applyOnNavigationController:(UINavigationController *)navigationController {
-	[self.background applyOnNavigationController:navigationController];
 	if (self.testID) {
 		navigationController.navigationBar.accessibilityIdentifier = self.testID;
 	}
 		}
 	}
 	
-	if ([self.blur boolValue]) {
-		if (![navigationController.navigationBar viewWithTag:BLUR_TOPBAR_TAG]) {
-			
-			[navigationController.navigationBar setBackgroundImage:[UIImage new] forBarMetrics:UIBarMetricsDefault];
-			navigationController.navigationBar.shadowImage = [UIImage new];
-			UIVisualEffectView *blur = [[UIVisualEffectView alloc] initWithEffect:[UIBlurEffect effectWithStyle:UIBlurEffectStyleLight]];
-			CGRect statusBarFrame = [[UIApplication sharedApplication] statusBarFrame];
-			blur.frame = CGRectMake(0, -1 * statusBarFrame.size.height, navigationController.navigationBar.frame.size.width, navigationController.navigationBar.frame.size.height + statusBarFrame.size.height);
-			blur.userInteractionEnabled = NO;
-			blur.tag = BLUR_TOPBAR_TAG;
-			[navigationController.navigationBar insertSubview:blur atIndex:0];
-			[navigationController.navigationBar sendSubviewToBack:blur];
-		}
-	} else {
-		UIView *blur = [navigationController.navigationBar viewWithTag:BLUR_TOPBAR_TAG];
-		if (blur) {
-			[navigationController.navigationBar setBackgroundImage: nil forBarMetrics:UIBarMetricsDefault];
-			navigationController.navigationBar.shadowImage = nil;
-			[blur removeFromSuperview];
-		}
-	}
-	
-	void (^disableTopBarTransparent)(void) = ^ {
-		UIView *transparentView = [navigationController.navigationBar viewWithTag:TOP_BAR_TRANSPARENT_TAG];
-		if (transparentView){
-			[transparentView removeFromSuperview];
-			[navigationController.navigationBar setBackgroundImage:self.originalTopBarImages[@"backgroundImage"] forBarMetrics:UIBarMetricsDefault];
-			navigationController.navigationBar.shadowImage = self.originalTopBarImages[@"shadowImage"];
-			self.originalTopBarImages = nil;
-		}
-	};
-	
-	if (self.transparent) {
-		if ([self.transparent boolValue]) {
-			if (![navigationController.navigationBar viewWithTag:TOP_BAR_TRANSPARENT_TAG]){
-				[self storeOriginalTopBarImages:navigationController];
-				[navigationController.navigationBar setBackgroundImage:[UIImage new] forBarMetrics:UIBarMetricsDefault];
-				navigationController.navigationBar.shadowImage = [UIImage new];
-				UIView *transparentView = [[UIView alloc] initWithFrame:CGRectZero];
-				transparentView.tag = TOP_BAR_TRANSPARENT_TAG;
-				[navigationController.navigationBar insertSubview:transparentView atIndex:0];
-			}
-		} else {
-			disableTopBarTransparent();
-		}
-	} else {
-		disableTopBarTransparent();
-	}
-	
 	if (self.barStyle) {
 		navigationController.navigationBar.barStyle = [RCTConvert UIBarStyle:self.barStyle];
 	} else {
 		navigationController.navigationBar.barStyle = UIBarStyleDefault;
 	}
 	
-	if (self.translucent) {
-		navigationController.navigationBar.translucent = [self.translucent boolValue];
-	} else {
-		navigationController.navigationBar.translucent = NO;
-	}
+	[self.background applyOnNavigationController:navigationController];
 }
 
 - (void)setRightButtonColor:(NSNumber *)rightButtonColor {
 	}
 }
 
--(void)storeOriginalTopBarImages:(UINavigationController *)navigationController {
-	NSMutableDictionary *originalTopBarImages = [@{} mutableCopy];
-	UIImage *bgImage = [navigationController.navigationBar backgroundImageForBarMetrics:UIBarMetricsDefault];
-	if (bgImage != nil) {
-		originalTopBarImages[@"backgroundImage"] = bgImage;
-	}
-	UIImage *shadowImage = navigationController.navigationBar.shadowImage;
-	if (shadowImage != nil) {
-		originalTopBarImages[@"shadowImage"] = shadowImage;
-	}
-	self.originalTopBarImages = originalTopBarImages;
-}
-
 @end

lib/ios/ReactNativeNavigationTests/RNNRootViewControllerTest.m

 
 -(void)testTopBarTranslucent {
 	NSNumber* topBarTranslucentInput = @(0);
-	self.options.topBar.translucent = topBarTranslucentInput;
+	self.options.topBar.background.translucent = topBarTranslucentInput;
 	__unused RNNNavigationController* nav = [self createNavigationController];
 	[self.uut viewWillAppear:false];
 	XCTAssertFalse(self.uut.navigationController.navigationBar.translucent);
 }
 
 -(void)testTopBarTransparent_BOOL_True {
-	NSNumber* topBarTransparentInput = @(1);
-	self.options.topBar.transparent = topBarTransparentInput;
+	NSNumber* transparentColor = @(0x00000000);
+	self.options.topBar.background.color = transparentColor;
 	__unused RNNNavigationController* nav = [self createNavigationController];
 	[self.uut viewWillAppear:false];
 	UIView* transparentView = [self.uut.navigationController.navigationBar viewWithTag:TOP_BAR_TRANSPARENT_TAG];
 }
 
 -(void)testTopBarTransparent_BOOL_false {
-	NSNumber* topBarTransparentInput = @(0);
+	NSNumber* inputColor = @(0xFFFF0000);
 	__unused RNNNavigationController* nav = [self createNavigationController];
-	self.options.topBar.transparent = topBarTransparentInput;
+	self.options.topBar.background.color = inputColor;
 	[self.uut viewWillAppear:false];
 	UIView* transparentView = [self.uut.navigationController.navigationBar viewWithTag:TOP_BAR_TRANSPARENT_TAG];
 	XCTAssertFalse(transparentView);
 }
 
-
--(void)testStoreOriginalTopBarImages {
-
-}
-
-
 -(void)testTopBarLargeTitle_default {
 	__unused RNNNavigationController* nav = [self createNavigationController];
 	[self.uut viewWillAppear:false];
 
 -(void)testTopBarBlur_false {
 	NSNumber* topBarBlurInput = @(0);
-	self.options.topBar.blur = topBarBlurInput;
+	self.options.topBar.background.blur = topBarBlurInput;
 	__unused RNNNavigationController* nav = [self createNavigationController];
 	[self.uut viewWillAppear:false];
 	XCTAssertNil([self.uut.navigationController.navigationBar viewWithTag:BLUR_TOPBAR_TAG]);
 
 -(void)testTopBarBlur_true {
 	NSNumber* topBarBlurInput = @(1);
-	self.options.topBar.blur = topBarBlurInput;
+	self.options.topBar.background.blur = topBarBlurInput;
 	__unused RNNNavigationController* nav = [self createNavigationController];
 	[self.uut viewWillAppear:false];
 	XCTAssertNotNil([self.uut.navigationController.navigationBar viewWithTag:BLUR_TOPBAR_TAG]);

lib/src/interfaces/Options.ts

   component?: {
     name?: string;
   };
+  /**
+   * Allows the NavBar to be translucent (blurred)
+   * #### (iOS specific)
+   */
+  translucent?: boolean;
+  /**
+   * Enable background blur
+   * #### (iOS specific)
+   */
+  blur?: boolean;
 }
 
 export interface OptionsTopBarButton {
    * @default 'default'
    */
   barStyle?: 'default' | 'black';
-  /**
-   * Allows the NavBar to be translucent (blurred)
-   * #### (iOS specific)
-   * @requires transparent: false
-   */
-  translucent?: boolean;
-  /**
-   * Allows the NavBar to be transparent
-   * #### (iOS specific)
-   */
-  transparent?: boolean;
   /**
    * Disable the border on bottom of the navbar
    * #### (iOS specific)
    * @default false
    */
   noBorder?: boolean;
-  /**
-   * Enable background blur
-   * #### (iOS specific)
-   */
-  blur?: boolean;
   /**
    * Show a UISearchBar in the Top Bar
    * #### (iOS 11+ specific)
   /**
    * Allows the Bottom Tabs to be translucent (blurred)
    * #### (iOS specific)
-   * @requires transparent: false
    */
   translucent?: boolean;
   /**

playground/src/screens/CustomTransitionOrigin.js

         largeTitle: {
           visible: false
         },
-        translucent: true
+        background: {
+          translucent: true
+        }
       }
     };
   }

playground/src/screens/OptionsScreen.js

   onClickTopBarTransparent = () => {
     Navigation.mergeOptions(this.props.componentId, {
       topBar: {
-        transparent: true
+        background: {
+          color: 'transparent'
+        }
       }
     });
   }
   onClickTopBarOpaque = () => {
     Navigation.mergeOptions(this.props.componentId, {
       topBar: {
-        transparent: false
+        background: {
+          color: 'white'
+        }
       }
     });
   }

playground/src/screens/PushedScreen.js

           text: 'single',
           testID: testIDs.TOP_BAR_BUTTON
         },
+        background: {
+          color: 'blue'
+        },
         rightButtonColor: 'red',
       },
-      layout: {
-        backgroundColor: '#f5fcff'
-      },
+      // layout: {
+      //   backgroundColor: '#f5fcff'
+      // },
       bottomTabs: {
         visible: false
       }

playground/src/screens/SearchScreen.js

           visible: true
         },
         searchBar: true,
-        translucent: true,
+        background: {
+          translucent: true
+        },
         searchBarPlaceholder: 'Start Typing'
       }
     };
             largeTitle: {
               visible: true
             },
-            translucent: true,
+            background: {
+              translucent: true
+            }
           }
         }
       },