UINavigationController inside a UITabBarController inside a UISplitViewController presented modally on iPhone

Question

I'm having a UISplitViewController that contains a UITabBarController as master view. This UITabBarController contains a UINavigationController. The detail view contains a UINavigationController as well.

On the iPad this works as expected. The show detail segue presents the imageview within the navigation controller on the detail view.

On the iPhone on the other hand I expected that the show detail segue pushes the detail view on the stack of the navigation controller of the master view. But actually it is presented modally over the master view.

When removing the UITabBarController from the storyboard and using the UINavigationController directly in the master view this works.

Has anybody an idea how I could present the detail view on the stack of the master's UINavigationController on an iPhone?

Answer 1

The problem with Peter's solution is that it will fall apart with the iPhone 6 +. How so? With that code, if an iPhone 6 + is in portrait orientation - the detail view pushes onto the navigation stack. All is well, so far. Now, rotate into landscape, and then you'll have the detail view showing as the detail view and the master view.

You'll need the split view controller's delegate to implement two methods:

- (BOOL)splitViewController:(UISplitViewController *)splitViewController showDetailViewController:(UIViewController *)detailVC sender:(id)sender
{
    UITabBarController *masterVC = splitViewController.viewControllers[0];

    if (splitViewController.traitCollection.horizontalSizeClass == UIUserInterfaceSizeClassCompact)
        [masterVC.selectedViewController showViewController:detailVC sender:sender];
    else
        [splitViewController setViewControllers:@[masterVC, detailVC]];

    return YES;
}

And now, you'll need to return the top view controller from the selected tab's navigation controller:

- (UIViewController*)splitViewController:(UISplitViewController *)splitViewController separateSecondaryViewControllerFromPrimaryViewController:(UIViewController *)primaryViewController
{
    UITabBarController *masterVC = splitViewController.viewControllers[0];

    if ([(UINavigationController*)masterVC.selectedViewController viewControllers].count > 1)
        return [(UINavigationController*)masterVC.selectedViewController popViewControllerAnimated:NO];
    else
        return nil; // Use the default implementation
}

With this solution, everything pushes onto the navigation stack when it should and also updates the detail view correctly on the iPad/6+ landscape.

Answer 2

I figured out how to put the detail on to the master's UINavigationController instead of presenting it modally over the UITabBarController.

Using the UISplitViewControllerDelegate method

- splitViewController:showDetailViewController:sender:

In case the UISplitViewController is collapsed get the masters navigation controller and push the detail view onto this navigation controller:

- (BOOL)splitViewController:(UISplitViewController *)splitViewController
   showDetailViewController:(UIViewController *)vc
                     sender:(id)sender {
    NSLog(@"UISplitViewController collapsed: %d", splitViewController.collapsed);

    // TODO: add introspection
    if (splitViewController.collapsed) {
        UITabBarController *master = (UITabBarController *) splitViewController.viewControllers[0];
        UINavigationController *masterNavigationController = (UINavigationController *)master.selectedViewController;

        // push detail view on the navigation controller
        //[masterNavigationController pushViewController:vc animated:YES];
        // push was not always working (see discussion in answer below), use showViewController instead
        [masterNavigationController showViewController:vc sender:sender];

        return YES;
    }

    return NO;
}

Answer 3

The answer of @PeterOettl to his own question put me on the right way and is great for that. So the credit belongs to him.

I have nearly the same storyboard structure as him, but as vc is a navigationController I get a runtime error saying

'Pushing a navigation controller is not supported'

As said, that is because vc is the navigationController of the detail view and not the viewController of the detail view.

Note that I am surprised that @PeterOettl does not get that error in his case also, as the segue given in the storyboard picture, points to the navigation controller of the detail view.

Therefore the code should like that (in Swift) simply adding

let detailViewControllerNavigationController = (vc as UINavigationController).viewControllers[0] as UIViewController

and pushing detailViewControllerNavigationController instead of vc

and the whole code is

func splitViewController(splitViewController: UISplitViewController, showDetailViewController vc: UIViewController, sender: AnyObject?) -> Bool {
    println("UISplitViewController collapsed: \(splitViewController.collapsed)")
    if (splitViewController.collapsed) {
        let master = splitViewController.viewControllers[0] as UITabBarController
        let masterNavigationController = master.selectedViewController as UINavigationController

        let detailViewControllerNavigationController = (vc as UINavigationController).viewControllers[0] as UIViewController

        masterNavigationController.pushViewController(detailViewControllerNavigationController, animated: true)

        return true
    } else {
        return false
    }
}

Also note that this code is put in the AppDelegate.swift of the master-detail example of Xcode where a tab bar is added in the master view.

EDIT

In the comments we discussed with @PeterOettl of the difference between .pushViewController and .showViewController.

Apple documentation says :

showViewController:sender:

This method pushes a new view controller onto the navigation stack in a similar way as the pushViewController:animated: method. You can call this method directly if you want but typically this method is called from elsewhere in the view controller hierarchy when a new view controller needs to be shown.

Available in iOS 8.0 and later.

Answer 4

I appreciate this discussion thread when I was implementing exactly the same UI structure app, and furthurmore made it adaptive for iPhone 6 Plus rotation and iPad multitasking (Slide Over/Split View, iOS 9 or later).

We have put the full solution (adaptive UISplitViewController with UITabBarController as primary view controller) open sourced on GitHub indievox-inc/TabBarSplitViewController. Thanks!

Answer 5

I implemented @Dreaming In Binary's answer in Swift:

func splitViewController(splitViewController: UISplitViewController, showDetailViewController vc: UIViewController, sender: AnyObject?) -> Bool {
    let masterVC = splitViewController.viewControllers[0] as UITabBarController

    if splitViewController.traitCollection.horizontalSizeClass == .Compact {
        masterVC.selectedViewController?.showViewController(vc, sender: sender)
    } else {
        splitViewController.viewControllers = [masterVC, vc]
    }

    return true
}

func splitViewController(splitViewController: UISplitViewController, separateSecondaryViewControllerFromPrimaryViewController primaryViewController: UIViewController!) -> UIViewController? {
    let masterVC = splitViewController.viewControllers[0] as UITabBarController

    if let navController = masterVC.selectedViewController as? UINavigationController {
        if navController.viewControllers.count > 1 {
            return navController.popViewControllerAnimated(false)
        }
    }
    return nil
}