Creating a Split View Controller Using a Storyboard

If you are creating a new Xcode project, the Master-Detail Application template gives you a split view in the storyboard, set as the first scene.

To add a split view controller to an existing app:

1. Open your application’s main storyboard.

2. Drag a split view controller out of the library.

   Interface Builder creates a split view controller a navigation controller and a view controller, and it creates relationships between them. These relationships identify the newly created view controllers as the left and right panes of the split view controller.

3. Display it as the first view controller by selecting the option Is Initial View Controller in the Attributes inspector (or present the view controller in your user interface in another way.)

The contents of the two view controllers you embed in the split view are your responsibility. You configure these view controllers just as you would configure any other view controllers in your application. For example, for embedded navigation and tab bar controllers, you may need to specify additional view controller information.

Creating a Split View Controller Programmatically

To create a split view controller programmatically, create a new instance of the UISplitViewController class and assign view controllers to its two properties. Because its contents are built on-the-fly from the view controllers you provide, you do not have to specify a nib file when creating a split view controller. Therefore, you can just use the init method to initialize it. Listing 4-1 shows an example of how to create and configure a split view interface at launch time. You would replace the first and second view controllers with the view controller objects that present your application’s content. The window variable is assumed to be an outlet that points to the window loaded from your application’s main nib file.

Listing 4-1  Creating a split view controller programmatically

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

{

   MyFirstViewController* firstVC = [[MyFirstViewController alloc] init];

   MySecondViewController* secondVC = [[MySecondViewController alloc] init];

   UISplitViewController* splitVC = [[UISplitViewController alloc] init];

   splitVC.viewControllers = [NSArray arrayWithObjects:firstVC, secondVC, nil];

    window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];

    window.rootViewController = splitVC;

   [window makeKeyAndVisible];

   return YES;

}

Supporting Orientation Changes in a Split View

A split view controller relies on its two contained view controllers to determine what orientations are supported. It only supports an orientation if both contained view controllers do. Even if one of the contained view controllers isn’t currently being displayed, it must support the orientation. When the orientation changes, the split view controller handles most of the rotation behaviors automatically.

In a landscape orientation, the split view controller presents the two panes side-by-side with a small divider separating them. In a portrait orientation, the split view controller either shows both panes or it shows only the second, larger pane and provides a toolbar button for displaying the first pane using a popover, depending on the value returned by the splitViewController:shouldHideViewController:inOrientation: delegate method.