Loading ViewController from xib file

Question

I had a MyViewController.swift and a MyViewController.xib presenting the layout of MyViewController.

I tried different methods to load this view controller including:

//1
let myVC = UINib(nibName: "MyViewController", bundle:
       nil).instantiateWithOwner(nil, options: nil)[0] as? MyViewController

//2
let myVC = NSBundle.mainBundle().loadNibNamed("MyViewController", owner: self, options: nil)[0] as? MyViewController

//3
let myVC = MyViewController(nibName: "MyViewController", bundle: nil)

The third one is the only successful initialisation, but the previous two are causing error:

Terminating app due to uncaught exception 'NSUnknownKeyException',

reason: '[ setValue:forUndefinedKey:]: this class is not key value coding-compliant for the key XXX.

What's wrong with those loading methods?

@bluenowhere Check all the outlets you have created and connected with components. Make sure there should not be any exclamation mark in the `Outlets` in `connection inspector` in your `.xib` file. — Vatsal K, May 05 '16 at 10:30
I believe the first two methods initialize your "MyViewController" class as a UIViewController and don't hook up the outlets and actions correctly, so the app crashes trying to find them. Initializing with your class' constructor hooks up the class outlets to the nib so everything works as it should. — Trev14, May 25 '18 at 14:10

score 111 · Answer 1 · answered Jun 21 '17 at 12:14

111

Swift 3

let myViewController = MyViewController(nibName: "MyViewController", bundle: nil)
self.present(myViewController, animated: true, completion: nil)

or push in navigation controller

self.navigationController!.pushViewController(MyViewController(nibName: "MyViewController", bundle: nil), animated: true)

answered Jun 21 '17 at 12:14

Marcos Reboucas

3,409
1
29
35

2

@Woodstock: Kind of! It is the correct answer to the question 'How do I load *the layout of* a ViewController from a XIB file'. However, the original question is ambiguous as OP doesn't seem to distinguish between (1) loading the layout (View) of a programmatically instantiated ViewController from a XIB, and (2) loading the ViewController instance *itself* from the XIB. AechoLiu's answer is the correct answer to the second interpretation :-) – Chris Hatton Sep 01 '17 at 13:26
4

if your vc name is same as xib file you can use (nibName: nil, bundle: nil) and it will work – Adam Smaka Nov 24 '18 at 16:32
3

I get error `loaded the "..." nib but the view outlet was not set.` – JCutting8 Jan 13 '20 at 11:19

score 40 · Answer 2 · answered Apr 22 '19 at 21:18

40

extension UIViewController {
    static func loadFromNib() -> Self {
        func instantiateFromNib<T: UIViewController>() -> T {
            return T.init(nibName: String(describing: T.self), bundle: nil)
        }

        return instantiateFromNib()
    }
}

Use it as the following:-

let testVC = TestVC.loadFromNib()

answered Apr 22 '19 at 21:18

SamehDos

1,183
1
10
23

2

This is a great approach to avoid a bunch of duplicate code! You should note that the name of the nib file needs to be the same as the name of the class. – toddg Jun 12 '19 at 21:06
1

Of course. The name of the nib file needs to be the same as the name of the class. – SamehDos Jun 19 '19 at 07:21

score 21 · Answer 3 · edited Dec 10 '19 at 05:06

Notice the File's Owner. In your case, the File's Owner must be MyViewController, or its sub-class.

And the following code, if it executes in class Foo.

// If `self` is an instance of `Foo` class.
// In this case, `File's Owner` will be a `Foo` instance due to the `self` parameter.
let myVC = NSBundle.mainBundle().loadNibNamed("MyViewController", owner: self, options: nil)[0] as? MyViewController

It assigns self as owner. So, the File's Owner is Foo, not MyViewController. Then, for Foo class, those IBOutlet cannot be connected to Foo. So, it throws exception.

score 4 · Answer 4 · answered Oct 19 '17 at 14:13

I had the same problem. The automatically generated xib had a UIView in it. You have to delete the view, add new view controller to the xib, set the view controller class to the one you want and then connect the outlets. After all of this you can use the codes provided above to get an instance of this view controller, like this:

if let menuVC = Bundle.main.loadNibNamed("MenuViewController", owner: nil, options: nil)?.first as? MenuViewController {
            menuVC.profileType = profileType
            vc.present(menuVC, animated: true, completion: nil)
        }

score 2 · Answer 5 · answered May 05 '16 at 09:28

The problem is not with the methods...you have probably kept an outlet(XXX) connected for some uielement and have removed it from corresponding controller...I am adding example below...

the above button is connected to controller now but when i comment outlet

my app crashes

so try to find outlet(xxx) that is missing from viewcontroller but is in xib file.Hope it helps :)

score 2 · Answer 6 · answered Sep 01 '21 at 08:08

You can use this small UIViewController extension

extension UIViewController {

    class func loadController() -> Self {
         return Self(nibName: String(describing: self), bundle: nil)
         //Or You can use this as well
         //Self.init(nibName: String(describing: self), bundle: nil)
    }
}

Use like this

let controller = CustomViewController.loadController()

score 1 · Answer 7 · answered May 05 '16 at 09:24

1

Try below code,

//1

let nib = UINib(nibName: "MyViewController", bundle:nil)
myVC = nib.instantiateWithOwner(self, options: nil)[0] as? MyViewController

OR

myVC = nib.instantiateWithOwner(self, options: nil).first as? MyViewController

//2

let nib : NSArray = NSBundle.mainBundle().loadNibNamed("MyViewController", owner: self, options: nil)
myVC = nib.objectAtIndex(0) as? MyViewController

This will work.

answered May 05 '16 at 09:24

Jigar Tarsariya

3,189
3
14
38

3

Please don't just put code explain what was mistake and how your code helps to solve it :) – Prashant Tukadiya May 05 '16 at 09:28
Yeah, as you can see the different skill for writing code. Some time it won't allow to initialize within one lines of code. – Jigar Tarsariya May 05 '16 at 09:32

score 1 · Answer 8 · answered Mar 29 '20 at 12:52

1

Updated for Swift 5

        let myVC = Bundle.main.loadNibNamed("MyViewController", owner: self, options: nil)![0] as? MyViewController

answered Mar 29 '20 at 12:52

rswayz

1,122
2
10
21

It is returning a nil value for myVC, something is missing in the code, try to add a full code snippet instead :) – Diego Jiménez Jan 18 '21 at 09:29

score 1 · Answer 9 · answered Jun 13 '20 at 01:11

Connect the UIButton with an @IBAction and add the following code to the action method to present a new UIViewController that is set up inside a .xib file.

@IBAction func handleButtonAction(_ sender: UIButton) {
    let viewControllerInXib = ViewControllerInXib(nibName: "ViewControllerXibName", bundle: nil)
    present(viewControllerInXib, animated: true)
}

To navigate via UINavigationController you should use this method:

@IBAction func handleButtonAction(_ sender: UIButton) {
    let viewControllerInXib = ViewControllerInXib(nibName: "ViewControllerXibName", bundle: nil)
    if let navigationController = navigationController {
        navigationController.pushViewController(viewControllerInXib, animated: true)
    } else {
        print("Navigation controller unavailable! Use present method.")
    }
}

ViewControllerInXib doesn't exists. – JBarros35 Oct 08 '20 at 14:19 — JBarros35, Oct 08 '20 at 14:19

score 0 · Answer 10 · answered Jul 24 '19 at 09:36

@AechoLiu's answer is great. I had the same question and answered it with the below fix.

Problem:

let vc1 = NSViewController(nibName: YDNibIdentifier.myplainvc, bundle: nil)

Fix:

let vc1 = MyPlainViewController(nibName: YDNibIdentifier.myplainvc, bundle: nil)

I had accidentally cast my Nib file to the wrong Clas ( NSViewController ), despite having it connected correctly inside the .xib file.

score 0 · Answer 11 · answered Apr 22 '21 at 03:01

public extension UIViewController {
static func loadNib() -> Self {
    func instantiateFromNib<T: UIViewController>() -> T {
        return T.init(nibName: String(describing: T.self), bundle: Bundle.init(for: Self.self))
    }
    return instantiateFromNib()
}

}

score 0 · Answer 12 · answered May 20 '21 at 13:03

This extension function didn't work for me.

static func loadFromNib() -> Self {
    func instantiateFromNib<T: UIViewController>() -> T {
        return T.init(nibName: String(describing: T.self), bundle: nil)
    }
    return instantiateFromNib()
}

It was throwing me

Could not load NIB in bundle: 'NSBundle ... with name 'UIViewController'

So, I changed it to this and got it working.

static func instantiateFromNib<T: UIViewController>() -> T {
    // It is going to return YourAppName.YourClassName
    let classDescription = classForCoder().description()
    // Replacing YourAppName with Empty string
    let nibFileName = classDescription.replacingOccurrences(of: "\(Bundle.main.infoDictionary?["CFBundleName"] as! String).", with: String())
    return T.init(nibName: nibFileName, bundle: Bundle.init(for: Self.self))
}

Just keep that in mind your .xib file and your .swift class name should be the same for it to work.

score -1 · Answer 13 · answered Apr 16 '20 at 06:15

-1

I removed File owner’s class name and set that to the class name of first view. And then I had to set outlets to the components which I’m going to use.

Then I loaded that view class like

let myViewController = Bundle.main.loadNibNamed("MyViewController", owner: self, options: nil)?.first as! MyViewController
view.addSubview(myViewController)

answered Apr 16 '20 at 06:15

Wimukthi Rajapaksha

961
1
11
23

follow https://stackoverflow.com/questions/47382566/could-not-cast-value-of-type-uiview-to-customview-using-xib/61243777#61243777 for more information. – Wimukthi Rajapaksha Apr 16 '20 at 06:16

score -4 · Answer 14 · answered Jan 20 '21 at 07:31

-4

Works this in Swift5

self.navigationController!.pushViewController(MyViewController(nibName: "MyViewController", bundle: nil), animated: true)

answered Jan 20 '21 at 07:31

emadhura

9
1

No difference using Swift 5 compared to the previous version. This is the same as the other answers. – Eric Aya Jan 20 '21 at 10:31

Loading ViewController from xib file

14 Answers14

Linked