navigator.setSubTitle() support for iOS (#1167)

Add setSubTitle implementation for iOS + docs

docs/screen-api.md

@@ -159,6 +159,17 @@ this.props.navigator.setTitle({
 });
 ```
 
+
+## setSubTitle(params = {})
+
+Set the nav bar subtitle dynamically. If your subtitle doesn't change during runtime, set it when the screen is defined / pushed.
+
+```js
+this.props.navigator.setSubTitle({
+  subtitle: "Connecting..." 
+});
+```
+
 ## toggleDrawer(params = {})
 
 Toggle the side menu drawer assuming you have one in your app.

ios/Helpers/RCCTitleViewHelper.h

@@ -23,7 +23,8 @@
 - (instancetype)init:(UIViewController*)viewController
 navigationController:(UINavigationController*)navigationController
                title:(NSString*)title subtitle:(NSString*)subtitle
-      titleImageData:(id)titleImageData;
+      titleImageData:(id)titleImageData
+       isSetSubtitle:(BOOL)isSetSubtitle;
 
 -(void)setup:(NSDictionary*)style;
 

ios/Helpers/RCCTitleViewHelper.m

@@ -23,6 +23,7 @@
 @property (nonatomic, strong) NSString *title;
 @property (nonatomic, strong) NSString *subtitle;
 @property (nonatomic, strong) id titleImageData;
+@property (nonatomic) BOOL isSetSubtitle;
 
 @property (nonatomic, strong) RCCTitleView *titleView;
 
@@ -35,12 +36,18 @@
 navigationController:(UINavigationController*)navigationController
                title:(NSString*)title subtitle:(NSString*)subtitle
       titleImageData:(id)titleImageData
+       isSetSubtitle:(BOOL)isSetSubtitle
+
 {
     self = [super init];
     if (self) {
         self.viewController = viewController;
         self.navigationController = navigationController;
-        self.title = [RCCTitleViewHelper validateString:title];
+        if(isSetSubtitle){
+            self.title = viewController.navigationItem.title;
+        } else {
+            self.title = [RCCTitleViewHelper validateString:title];
+        }
         self.subtitle = [RCCTitleViewHelper validateString:subtitle];
         self.titleImageData = titleImageData;
     }

ios/RCCNavigationController.m

@@ -333,12 +333,13 @@ NSString const *CALLBACK_ASSOCIATED_ID = @"RCCNavigationController.CALLBACK_ASSO
                   props:(NSDictionary*)props
                   style:(NSDictionary*)style
 {
-  
+  BOOL isSetSubtitleBool = props[@"isSetSubtitle"] ? [props[@"isSetSubtitle"] boolValue] : NO;
   RCCTitleViewHelper *titleViewHelper = [[RCCTitleViewHelper alloc] init:viewController
                                                     navigationController:self
                                                                    title:props[@"title"]
                                                                 subtitle:props[@"subtitle"]
-                                                          titleImageData:props[@"titleImage"]];
+                                                          titleImageData:props[@"titleImage"]
+                                                           isSetSubtitle:isSetSubtitleBool];
   
   [titleViewHelper setup:style];
   

ios/RCCViewController.m

@@ -266,7 +266,7 @@ const NSInteger TRANSPARENT_NAVBAR_TAG = 78264803;
   if (self.navigationItem.titleView && [self.navigationItem.titleView isKindOfClass:[RCCTitleView class]]) {
     
     RCCTitleView *titleView = (RCCTitleView *)self.navigationItem.titleView;
-    RCCTitleViewHelper *helper = [[RCCTitleViewHelper alloc] init:viewController navigationController:viewController.navigationController title:titleView.titleLabel.text subtitle:titleView.subtitleLabel.text titleImageData:nil];
+    RCCTitleViewHelper *helper = [[RCCTitleViewHelper alloc] init:viewController navigationController:viewController.navigationController title:titleView.titleLabel.text subtitle:titleView.subtitleLabel.text titleImageData:nil isSetSubtitle:NO];
     [helper setup:self.navigatorStyle];
   }
   

src/deprecated/platformSpecificDeprecated.ios.js

@@ -306,7 +306,18 @@ function navigatorSetTitle(navigator, params) {
     title: params.title,
     subtitle: params.subtitle,
     titleImage: params.titleImage,
-    style: params.navigatorStyle
+    style: params.navigatorStyle,
+    isSetSubtitle: false
+  });
+}
+
+function navigatorSetSubtitle(navigator, params) {
+  Controllers.NavigationControllerIOS(navigator.navigatorID).setTitle({
+    title: params.title,
+    subtitle: params.subtitle,
+    titleImage: params.titleImage,
+    style: params.navigatorStyle,
+    isSetSubtitle: true
   });
 }
 
@@ -594,6 +605,7 @@ export default {
   dismissInAppNotification,
   navigatorSetButtons,
   navigatorSetTitle,
+  navigatorSetSubtitle,
   navigatorSetStyle,
   navigatorSetTitleImage,
   navigatorToggleDrawer,