Using Multiple Storyboards in iOS

Question

My objective is to create a tabbed application, then the view for each of the tabs are constructed in separate storyboards.

Storyboard screenshot

My mainstoryboard is a tab view.

Then I create a secondary storyboard (storyboard#2) with 2 View Controllers. The first view controller (also ticked as initial) have a button, and segue (modal) to 2nd view.

I managed to load the view by subclassing and overriding loadView from storyboard#2. loadView override

Here's the simulator output.

Simulator

When click on the "click me" button, I get a EXC_BAD_ACCESS. The segue does not work, seems like the second storyboard is not being loaded completely.

Has anyone tried to do this before and get it working? There's a youtube video from SkillMaster.net but he does not demonstrate if a segue is working under the secondary storyboard. the video is here: http://youtu.be/D4_twoYvB4M

Thanks for any input and help!

Screenshots:

i am not sure if this is a good practice neither, but i want to: 1. NOT having one big/bloated storyboard 2. difficult to merge code (we have few coders working and commit) — Daddycat Tan Yin See, Nov 28 '11 at 15:03
Maybe you could try simply using the .xib files we used pre-iOS5? They shouldn't be too hard to combine with storyboards. — Tom van der Woerdt, Nov 28 '11 at 15:05
i would like to know if we can use Storyboard to do this. XIB will definitely work. — Daddycat Tan Yin See, Nov 28 '11 at 15:07
+1000 for the big merge conflict friendly XML file split idea — Pierre de LESPINAY, Jun 16 '14 at 13:45
Several storyboards can make sense when you're building a product line, not the single product. In this case, you have one storyboard for core/vanilla product and one storyboard for each customized product — Kirill Gamazkov, Aug 29 '14 at 10:37
I tried to improve that with a better solution https://github.com/jeremygrenier/JGLinkedStoryboard — Jeremy Grenier, Nov 22 '14 at 15:15

score 82 · Answer 1 · edited May 23 '17 at 12:32

These are the best articles I've seen on multiple storyboards.

Not only does this guy tell you how to create a new storyboard in code, he

recommends multiple storyboards in practice (more modular code)
discusses when to use xibs vs storyboards (xibs hold views, storboards are based on controllers)
provides a class for linking storyboards with segues on github

Note that this last point is important because the key downside of multiple storyboards is that you can't usually link them with segues, but robs library allows that with a bit of fudging

Also see the discussed here

score 44 · Answer 2 · edited Oct 04 '16 at 15:20

44

The OP edited his question to include the answer:

UIStoryboard* storyboard = [UIStoryboard storyboardWithName:@"HelpStoryboard" bundle:nil];
UIViewController* initialHelpView = [storyboard instantiateInitialViewController];

initialHelpView.modalPresentationStyle = UIModalPresentationFormSheet;
[self presentModalViewController:initialHelpView animated:YES];

Of course, where you call this from is meaningful, because you might have 2 storyboards and their view stack in memory. So probably best if you call this code from outside the other storyboard's view controllers.

edited Oct 04 '16 at 15:20

rptwsthi

10,094
10
68
109

answered Dec 15 '11 at 07:25

pchap10k

2,066
2
19
30

2

that question was removed from SO :-(. In any case, where do you think you would put this snippet in this use case? I am facing the same situation, and I can't really see where I could hook up with `UITabbarController` to instantiate the correct storyboard for each tab. Would the delegate `tabBarController:shouldSelectViewController:` be appropriate? – Jean-Denis Muys Jan 06 '12 at 15:49
2

I'm using the above approach but not with a tab bar. I put this code in the action method specified by the selector for the button. Basically the code is the same as I had in prepareForSegue before I moved the segued-to scene into its own storyboard. One mistake I made initially was that my new storyboard had its main view embedded in a UINavigationController - and after setting it up I tried to present the view instead of the nav controller. – Rhubarb Oct 03 '12 at 09:53

score 19 · Answer 3 · answered Oct 31 '13 at 09:15

I've examined the RBStoryboardLink approach suggested by Rhubarb. This implementation substitutes view controller's properties which looks odd. I believe I've found the way to avoid this. Here is the demo project.

Navigation controllers

Navigation controllers could just set a referenced view controller as a root. Implementation of such view controller may look like this:

@interface ExternNavigationController : UINavigationController

@property (strong, nonatomic) NSString *storyboardName;
@property (strong, nonatomic) NSString *sceneIdentifier;

@end

@implementation ExternNavigationController

- (void)awakeFromNib
{
    NSAssert(self.storyboardName, @"storyboardName is required");

    UIStoryboard *storyboard = [UIStoryboard storyboardWithName:self.storyboardName bundle:nil];
    UIViewController *vc = self.sceneIdentifier
        ? [storyboard instantiateViewControllerWithIdentifier:self.sceneIdentifier]
        : [storyboard instantiateInitialViewController];

    self.viewControllers = @[vc];
}

@end

View controllers

Problems begin when you want to push a view controller defined in an external storyboard. This is the case when properties are copied. Instead of this, we can implement a custom segue which will substitute a fake destination controller with a real one from external storyboard.

@interface ExternStoryboardSegue : UIStoryboardSegue

@end

@implementation ExternStoryboardSegue

- (id)initWithIdentifier:(NSString *)identifier source:(UIViewController *)source destination:(ExternViewController *)destination
{
    NSAssert(destination.storyboardName, @"storyboardName is required");

    UIStoryboard *storyboard = [UIStoryboard storyboardWithName:destination.storyboardName bundle:nil];
    UIViewController *vc = destination.sceneIdentifier
        ? [storyboard instantiateViewControllerWithIdentifier:destination.sceneIdentifier]
        : [storyboard instantiateInitialViewController];

    return [super initWithIdentifier:identifier source:source destination:vc];
}

- (void)perform
{
    [[self.sourceViewController navigationController] pushViewController:self.destinationViewController animated:YES];
}

@end

ExternViewController is used as a placeholder and contains required for substitution properties (storyboardName and sceneIdentifier).

@interface ExternViewController : UIViewController

@property (strong, nonatomic) NSString *storyboardName;
@property (strong, nonatomic) NSString *sceneIdentifier;

@end

@implementation ExternViewController

@end

We need to set these properties and custom class for placeholder view controller. And also link view controller with ExternStoryboardSegue.

IB screenshot

I tried to improve that with a better solution https://github.com/jeremygrenier/JGLinkedStoryboard — Jeremy Grenier, Nov 22 '14 at 15:13

score 16 · Answer 4 · answered Apr 24 '12 at 08:49

From one of my XIB files I am navigating into a more complicated part of the GUI, and for this part I am using a Storyboard. So a button in my XIB will navigate to the storyboard. The code I have for this is:

UIStoryboard* storyboard = [UIStoryboard storyboardWithName:@"MyStoryboardIdentifier" bundle:nil];
UIViewController* myStoryBoardInitialViewController = [storyboard instantiateInitialViewController];

[self.navigationController pushViewController:myStoryBoardInitialViewController animated:YES];

This will successfully push my StoryBoard onto the view. The code above is called from a buttons "Touch Up Inside" action.

score 9 · Answer 5 · answered Oct 15 '15 at 08:18

As from Xcode 7(and ported back to iOS8) you can now have storyboard references. It was mentioned in this WWDC 2015 session(it starts talking about them around first hour). Basically all you had to do is select ViewController's which you wish to move to separate storyboard, and click on Editor->Refactor to Storyboard.... Give it a name and voila:

Please note that if you had VC's which are moved to the new storyboard, and are not referenced outside of it(what it should be), you should delete their references from main.storyboard(relax they will remain in newly created storyboard, you are deleting only references to them).

score 7 · Answer 6 · answered Nov 28 '11 at 16:17

7

Apple's docs say that you may have multiple storyboards. Unfortunately they don't go into any real detail on how to do that. As you've found out, Interface Builder won't help you, so you'll have to do it in code. It works much like loading XIBs:

[UIStoryboard storyboardWithName:@”MyNewStoryboard” bundle:myBundle]

Having said that, if you don't "want one big/bloated storyboard" as you said in your comment then XIBs really are the way to go. That 'bigness' is the benefit: all the transitions between VCs are laid out in one place. Having multiple storyboards is really so that you can support multiple different and unrelated flows through your app: for example, one storyboard for a complex configuration flow and another one for the main user flow.

answered Nov 28 '11 at 16:17

Tim

5,024
2
30
58

25

The biggest issue is when you are working on a team of 3+ where merging a single storyboard is a nightmare. – Brian Liang Dec 12 '11 at 20:41
2

I can imagine that's a problem. There are quite a few rough edges with storyboards; your point is one more. – Tim Dec 12 '11 at 22:14
4

You don't have to drop away all the comfort provided by storyboards just to avoid merging nightmares. Just isolate different independent areas and assign each one a separate storyboard. You'll still have all the magic of the storyboards for all the internal transitions. A tabbed application is a perfect fit for this scenario. A settings screen too. Even if you're a single developer it might still be relevant to split up your storyboard in several independant pieces. – KPM Jul 31 '12 at 16:17

score 3 · Answer 7 · answered Jan 17 '17 at 18:53

Xcode 8.2.1

You can reference a view controller in an external storyboard.

drag a connection from the UITabBarController to the external Storyboard Reference, add it as a "view controllers" relationship. In the main storyboard it shows as "Item/square", but in the external storyboard you should add a UITabBarItem and define the name and image/s for the tab.

Attributes inspector when the Storyboard Reference is selected.

You will also need to give the external controller a "Storyboard ID" in its storyboard (not shown here), and reference it's name in the reference.

score 2 · Answer 8 · answered Feb 23 '13 at 19:06

I've found that if you have a named segue in a second storyboard that you want to use in a call to performSegueWithIdenitfier: you must set the "Storyboard ID" field in the "Identity" tab on the source ViewController.

For example if you gave a VC called "ViewController1" with a segue called "segue1" to another VC, set the "Storyboard ID" of "ViewController1" to whatever (say "viewC1" or something) and then in ViewController1.m you can use [self performSegueWithIdentifier:@"segue1" sender:self].

score 1 · Answer 9 · answered May 23 '18 at 05:07

Follow below steps to achieve this task:

Step 1 : Search for an Storyboard Reference in components (Refer Screen Shot)

Step 2 : Select new storyboard reference. (Refer Screen Shot)

Step 3: Provide new storyboard name and identifier of initial view controller's identifier (Refer Screen Shot)

Build and Run. It will Work.

Using Multiple Storyboards in iOS

9 Answers9

Navigation controllers

View controllers

Xcode 8.2.1

Linked

Related