Instantiate and Present a viewController in Swift

Question

Issue

I started taking a look of the new Swift on Xcode 6, and I tried some demo projects and tutorials. Now I am stuck at:

Instantiating and then presenting a viewController from a specific storyboard

Objective-C Solution

UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"myStoryboardName" bundle:nil];
UIViewController *vc = [storyboard instantiateViewControllerWithIdentifier:@"myVCID"];
[self presentViewController:vc animated:YES completion:nil];

How to achieve this on Swift?

akashivskyy · Accepted Answer · 2021-05-12T10:24:57.527

689

This answer was last revised for Swift 5.4 and iOS 14.5 SDK.

It's all a matter of new syntax and slightly revised APIs. The underlying functionality of UIKit hasn't changed. This is true for a vast majority of iOS SDK frameworks.

let storyboard = UIStoryboard(name: "myStoryboardName", bundle: nil)
let vc = storyboard.instantiateViewController(withIdentifier: "myVCID")
self.present(vc, animated: true)

Make sure to set myVCID inside the storyboard, under "Storyboard ID."

edited May 12 '21 at 10:24

answered Jun 04 '14 at 11:22

akashivskyy

40,844
15
103
113

3

You can even omit the `;`! ;) Would you mind elaborating on the `as UIViewController`? Why is that necessary? – Sebastian Wramba Jun 04 '14 at 11:23
5

`as` keyword is used for typecasting. It's the same as `(UIViewController *)anObject` in objective c – Garoal Jun 04 '14 at 11:25
1

Yeah I know I can omit them but that's a part of the long habbit. :D As `instantiateViewControllerWithIdentifier` returns `AnyObject` (`id` equivalent in Swift) and I declare `vc` as `UIViewController`, I have to typecast `AnyObject` to `UIViewController`. – akashivskyy Jun 04 '14 at 11:27
Hi Friends, i am facing some different issue, This code run on simulator not on my ipad2 which having iOS v7.1.2. If you dont mind help me to resolve this issue. – Indra Sep 14 '14 at 03:25
the "as UIViewController" can also be "as CustomViewControllerSubclass". You're not always going to want to instantiate *just* a UIViewController from a storyboard. – mmc Dec 25 '14 at 23:27
3

@akashivskyy Most definitely, to you. But maybe not to some. – mmc Dec 25 '14 at 23:33
with Swift 1.2, the `as` should be changed to `as!` (more info: https://developer.apple.com/swift/blog/?id=23) – matt--- Apr 18 '15 at 06:15
As of Swift 2 `instantiateViewControllerWithIdentifier` returns `UIViewController` so you don't need to unroll anymore. So things simplify: `let storyboard = UIStoryboard(name: "MyStoryboardName", bundle: nil); let vc = storyboard.instantiateViewControllerWithIdentifier("someViewController"); self.presentViewController(vc, animated: true, completion: nil)` – Adam Sep 11 '15 at 17:13
for ios9 as! UIViewController no need it "Forced cast of 'UIViewController' to same type has no effect" – iluvatar_GR Sep 30 '15 at 04:59
If I go to second viewController in tabBarController, How do I do? If I direct to second viewController than does not show TavBarController. – Nov 01 '16 at 04:32
Is it necessary to instantiate the storyboard object each time or I thing it can be made static to reuse it. Am I correct with this approach. – Shubham Ojha Nov 14 '17 at 14:51
@akashivskyy In the new syntax. I don't need the extra "as UINavigationController" then? In let controller = storyboard.instantiateViewController(withIdentifier: "someViewController") – Cons Bulaquena Apr 26 '18 at 09:41
I don't think completion is required. – Daniel Springer Nov 12 '18 at 22:03
it's better to use with navigation `self.navigationController?.show(controller, sender: nil)` – user25 Mar 08 '19 at 15:40
@user25 It's not. – akashivskyy Mar 09 '19 at 23:03
yes, it is. if you have more than one controller then you have to add navigation controller – user25 Mar 10 '19 at 10:26
it showing me condition of iOS 13 ?? how can I do for iOS 12 ? Thank You. – Yogesh Patel Oct 04 '19 at 09:30

E-Riddie · Answer 2 · 2017-07-13T13:02:56.583

43

For people using @akashivskyy's answer to instantiate UIViewController and are having the exception:

fatal error: use of unimplemented initializer 'init(coder:)' for class

Quick tip:

Manually implement required init?(coder aDecoder: NSCoder) at your destination UIViewController that you are trying to instantiate

required init?(coder aDecoder: NSCoder) {
    super.init(coder: aDecoder)
}

If you need more description please refer to my answer here

edited Jul 13 '17 at 13:02

answered Jun 04 '14 at 11:30

E-Riddie

14,052
7
47
70

If you want to use custom initiator you can just call the super with super.init(nibName: nil, bundle: nil) and the whew will load fine or do call it with the name of them NIB file. – Lars Christoffersen Jun 09 '14 at 22:58
4

@user1700737 I am instantiating the viewController referring to storyboard, which executes initWithCoder, not initWithNib. Refer to this question http://stackoverflow.com/questions/24036393/fatal-error-use-of-unimplemented-initializer-initcoder-for-class/24036440#24036440 – E-Riddie Jun 10 '14 at 06:15
Hi Friends, i am facing some different issue, This code run on simulator not on my ipad2 which having iOS v7.1.2. If you dont mind help me to resolve this issue. – Indra Sep 14 '14 at 03:26
@Indra you need to ask another question on stack, give me the link Ill be happy to help you! – E-Riddie Sep 14 '14 at 07:35
On Swift 1.2 you must make `init(coder aDecoder: NSCoder!)` "required". So now you have to write the following: `required init(coder aDecoder: NSCoder!)` – Eduardo Viegas Jun 12 '15 at 17:35

score 20 · Answer 3 · edited May 23 '17 at 11:47

This link has both the implementations:

Swift:

let viewController:UIViewController = UIStoryboard(name: "Main", bundle: nil).instantiateViewControllerWithIdentifier("ViewController") as UIViewController
self.presentViewController(viewController, animated: false, completion: nil)

Objective C

UIViewController *viewController = [[UIStoryboard storyboardWithName:@"MainStoryboard" bundle:nil] instantiateViewControllerWithIdentifier:@"ViewController"];

This link has code for initiating viewcontroller in the same storyboard

/*
 Helper to Switch the View based on StoryBoard
 @param StoryBoard ID  as String
*/
func switchToViewController(identifier: String) {
    let viewController = self.storyboard?.instantiateViewControllerWithIdentifier(identifier) as! UIViewController
    self.navigationController?.setViewControllers([viewController], animated: false)

}

Nahuel Roldan · Answer 4 · 2016-03-07T18:29:47.260

akashivskyy's answer works just fine! But, in case you have some trouble returning from the presented view controller, this alternative can be helpful. It worked for me!

Swift:

let storyboard = UIStoryboard(name: "MyStoryboardName", bundle: nil)
let vc = storyboard.instantiateViewControllerWithIdentifier("someViewController") as! UIViewController
// Alternative way to present the new view controller
self.navigationController?.showViewController(vc, sender: nil)

Obj-C:

UIStoryboard *storyboard = [UIStoryboard storyboardWithName:@"MyStoryboardName" bundle:nil];
UIViewController *vc = [storyboard instantiateViewControllerWithIdentifier:@"someViewController"];
[self.navigationController showViewController:vc sender:nil];

score 13 · Answer 5 · answered Dec 05 '18 at 13:14

13

Swift 4.2 updated code is

let storyboard = UIStoryboard(name: "StoryboardNameHere", bundle: nil)
let controller = storyboard.instantiateViewController(withIdentifier: "ViewControllerNameHere")
self.present(controller, animated: true, completion: nil)

answered Dec 05 '18 at 13:14

Shahzaib Maqbool

1,331
13
22

score 7 · Answer 6 · answered Jan 08 '15 at 17:17

// "Main" is name of .storybord file "
let mainStoryboard: UIStoryboard = UIStoryboard(name: "Main", bundle: nil)
// "MiniGameView" is the ID given to the ViewController in the interfacebuilder
// MiniGameViewController is the CLASS name of the ViewController.swift file acosiated to the ViewController
var setViewController = mainStoryboard.instantiateViewControllerWithIdentifier("MiniGameView") as MiniGameViewController
var rootViewController = self.window!.rootViewController
rootViewController?.presentViewController(setViewController, animated: false, completion: nil)

This worked fine for me when i put it in AppDelegate

Hamid · Answer 7 · 2016-05-26T20:41:01.680

7

If you want to present it modally, you should have something like bellow:

let vc = self.storyboard!.instantiateViewControllerWithIdentifier("YourViewControllerID")
self.showDetailViewController(vc as! YourViewControllerClassName, sender: self)

edited May 26 '16 at 20:41

answered May 26 '16 at 20:26

Hamid

2,272
1
25
41

score 6 · Answer 8 · edited Dec 04 '18 at 19:33

I would like to suggest a much cleaner way. This will be useful when we have multiple storyboards

1.Create a structure with all your storyboards

struct Storyboard {
      static let main = "Main"
      static let login = "login"
      static let profile = "profile" 
      static let home = "home"
    }

2. Create a UIStoryboard extension like this

extension UIStoryboard {
  @nonobjc class var main: UIStoryboard {
    return UIStoryboard(name: Storyboard.main, bundle: nil)
  }
  @nonobjc class var journey: UIStoryboard {
    return UIStoryboard(name: Storyboard.login, bundle: nil)
  }
  @nonobjc class var quiz: UIStoryboard {
    return UIStoryboard(name: Storyboard.profile, bundle: nil)
  }
  @nonobjc class var home: UIStoryboard {
    return UIStoryboard(name: Storyboard.home, bundle: nil)
  }
}

Give the storyboard identifier as the class name, and use the below code to instantiate

let loginVc = UIStoryboard.login.instantiateViewController(withIdentifier: "\(LoginViewController.self)") as! LoginViewController

@StackRunner this will not be available to objective c – XcodeNOOB Oct 28 '19 at 13:25 — XcodeNOOB, Oct 28 '19 at 13:25

score 3 · Answer 9 · answered May 18 '18 at 19:36

3

Swift 4:

    let storyboard = UIStoryboard(name: "Main", bundle: nil)
    let yourVC: YourVC = storyboard.instantiateViewController(withIdentifier: "YourVC") as! YourVC

answered May 18 '18 at 19:36

drew..

2,384
2
14
19

score 2 · Answer 10 · answered Mar 14 '17 at 20:19

2

If you have a Viewcontroller not using any storyboard/Xib, you can push to this particular VC like below call :

 let vcInstance : UIViewController   = yourViewController()
 self.present(vcInstance, animated: true, completion: nil)

answered Mar 14 '17 at 20:19

Aks

4,339
1
33
32

I get this: "cannot be constructed because it has no accessible initializers". – Paul Bénéteau Oct 07 '17 at 21:09
the outlets and other relationships made by the storyboard are lost – jose920405 May 25 '18 at 19:32

score 2 · Answer 11 · edited May 13 '17 at 03:39

2

Swift 3 Storyboard

let settingStoryboard : UIStoryboard = UIStoryboard(name: "SettingViewController", bundle: nil)
let settingVC = settingStoryboard.instantiateViewController(withIdentifier: "SettingViewController") as! SettingViewController
self.present(settingVC, animated: true, completion: {

})

edited May 13 '17 at 03:39

Nathan Tuggy

2,239
27
28
36

answered May 13 '17 at 03:10

Giang

3,031
26
26

score 1 · Answer 12 · answered Feb 25 '17 at 19:17

I know it's an old thread, but I think the current solution (using hardcoded string identifier for given view controller) is very prone to errors.

I've created a build time script (which you can access here), which will create a compiler safe way for accessing and instantiating view controllers from all storyboard within the given project.

For example, view controller named vc1 in Main.storyboard will be instantiated like so:

let vc: UIViewController = R.storyboard.Main.vc1^  // where the '^' character initialize the controller

score 1 · Answer 13 · answered Mar 08 '18 at 11:58

No matter what I tried, it just wouldn't work for me - no errors, but no new view controller on my screen either. Don't know why, but wrapping it in timeout function finally made it work:

DispatchQueue.main.asyncAfter(deadline: .now() + 0.0) {
    let storyboard = UIStoryboard(name: "Main", bundle: nil)
    let controller = storyboard.instantiateViewController(withIdentifier: "TabletViewController")
    self.present(controller, animated: true, completion: nil)
}

score 1 · Answer 14 · answered Jan 06 '20 at 13:07

1

Swift 5

let vc = self.storyboard!.instantiateViewController(withIdentifier: "CVIdentifier")
self.present(vc, animated: true, completion: nil)

answered Jan 06 '20 at 13:07

Binoy jose

413
4
9

score 0 · Answer 15 · answered Oct 13 '18 at 12:59

0

I created a library that will handle this much more easier with better syntax:

https://github.com/Jasperav/Storyboardable

Just change Storyboard.swift and let the ViewControllers conform to Storyboardable.

answered Oct 13 '18 at 12:59

J. Doe

9,757
4
42
83

score 0 · Answer 16 · edited Nov 12 '20 at 19:26

0

guard let vc = storyboard?.instantiateViewController(withIdentifier: "add") else { return }
        vc.modalPresentationStyle = .fullScreen
        present(vc, animated: true, completion: nil)

edited Nov 12 '20 at 19:26

Ironkey

2,492
1
5
27

answered Nov 12 '20 at 12:30

MdYaz

11

Please add some explanation to your answer. Explaining the underlying logic is more important than just giving the code. It helps the author and other readers fix this and similar issues themselves while giving them the clues to the knowledge they need to expand their programming skills. – Ironkey Nov 12 '20 at 19:26

Instantiate and Present a viewController in Swift

Issue

Objective-C Solution

16 Answers16

Linked

Related