Set a custom subclass of UINavigationBar in UINavigationController programmatically

Question

Does anyone know how can I use my custom subclass of UINavigationBar if I instantiate UINavigationController programmatically (without IB)?

<

Answer 1

As far as I can tell, sometimes it is indeed necessary to subclass UINavigationBar, to do some nonstandard restyling. It's sometimes possible to avoid having to do so by using categories, but not always.

Currently, as far as I know, the only way to set a custom UINavigationBar within a UIViewController is via IB (that is, via an archive) - it probably shouldn't be that way, but for now, we gotta live with it.

This is often fine, but sometimes using IB isn't really feasible.

So, I saw three options:

1. Subclass UINavigationBar and hook it all up in IB, then muck about loading up the nib each time I wanted a UINavigationController,
2. Use method replacement within a category to change the behaviour of UINavigationBar, rather than subclassing, or
3. Subclass UINavigationBar and do a little mucking about with archiving/unarchiving the UINavigationController.

Option 1 was unfeasible (or at least too annoying) for me in this case, as I needed to create the UINavigationController programmatically, 2 is a little dangerous and more of a last-resort option in my opinion, so I chose option 3.

My approach was to create a 'template' archive of a UINavigationController, and unarchive that, returning it in initWithRootViewController.

Here's how:

In IB, I created a UINavigationController with the appropriate class set for the UINavigationBar.

Then, I took the existing controller, and saved an archived copy of it using +[NSKeyedArchiver archiveRootObject:toFile:]. I just did this within the app delegate, in the simulator.

I then used the 'xxd' utility with the -i flag, to generate c code from the saved file, to embed the archived version in my subclass (xxd -i path/to/file).

Within initWithRootViewController I unarchive that template, and set self to the result of the unarchive:

// This is the data from [NSKeyedArchiver archivedDataWithRootObject:controller], where
// controller is a CTNavigationController with navigation bar class set to CTNavigationBar,
// from IB.  This c code was created using 'xxd -i'
static unsigned char archived_controller[] = {
    0x62, 0x70, 0x6c, 0x69, 0x73, 0x74, 0x30, 0x30, 0xd4, 0x01, 0x02, 0x03,
    ...
};
static unsigned int archived_controller_len = 682;

...

- (id)initWithRootViewController:(UIViewController *)rootViewController {
     // Replace with unarchived view controller, necessary for the custom navigation bar
     [self release];
     self = (CTNavigationController*)[NSKeyedUnarchiver unarchiveObjectWithData:[NSData dataWithBytes:archived_controller length:archived_controller_len]];
     [self setViewControllers:[NSArray arrayWithObject:rootViewController]];
     return [self retain];
}

Then, I can just grab a new instance of my UIViewController subclass which has the custom navigation bar set:

UIViewController *modalViewController = [[[CTNavigationController alloc] initWithRootViewController:myTableViewController] autorelease];
[self.navigationController presentModalViewController:modalViewController animated:YES];

This gives me a modal UITableViewController with a navigation bar and toolbar all set up, and with the custom navigation bar class in place. I didn't need to do any slightly-nasty method replacement, and I don't have to muck about with nibs when I really just want to work programmatically.

I would like to see the equivalent of +layerClass within UINavigationController - +navigationBarClass - but for now, this works.

Answer 2

Michael's solution works, but you can avoid NSKeyedArchiver and 'xxd' utility. Simply Subclass UINavigationController and override initWithRootViewController, loading your custom NavigationController NIB directly:

- (id) initWithRootViewController:(UIViewController *)rootViewController
{
    [self release];
    self = [[[[NSBundle mainBundle] loadNibNamed:@"CTNavigationController" owner:nil options:nil] objectAtIndex:0] retain];  
    [self setViewControllers:[NSArray arrayWithObject:rootViewController]];
    return self;
}

Answer 3

You don't need to muck with the XIB simply use KVC.

[self.navigationController setValue:[[[CustomNavBar alloc]init] autorelease] forKeyPath:@"navigationBar"];

Answer 4

Update: Using object_SetClass() no longer works as if iOS5 GM. An alternate solution has been added below.

Use NSKeyedUnarchiver to manually set the unarchive class for the nav bar.

   MyViewController *controller = [[[MyViewController alloc] init] autorelease];
   NSKeyedUnarchiver *unarchiver = [[[NSKeyedUnarchiver alloc] initForReadingWithData:[NSKeyedArchiver archivedDataWithRootObject:controller]] autorelease];
   [unarchiver setClass:[MyNavigationBar class] forClassName:@"UINavigationBar"];
   controller = [unarchiver decodeObjectForKey:@"root"];

---

Note: This original solution only works pre-iOS5:

There is a great solution, which I posted here -- inject navBar subclass directly into your view the UINavigationController:

#import <objc/runtime.h>

- (void)viewDidLoad {
    [super viewDidLoad];

    object_setClass(self.navigationController.navigationBar, [MyNavBar class]);
    // the rest of your viewDidLoad code
}

Answer 5

These category methods are dangerous and not for novices. Also the complication with iOS4 and iOS5 being different, makes this an area that can cause bugs for many people. Here is a simple subclass that I use that supports iOS4.0 ~ iOS6.0 and is very simply.

.h

@interface XXXNavigatioNBar : UINavigationBar
@end

.m

#import "XXXNavigationBar.h"

#import <objc/runtime.h>

@implementation XXXNavigationBar

- (void) didMoveToSuperview {
    if( [self respondsToSelector: @selector(setBackgroundImage:forBarMetrics:)]) {
        //iOS5.0 and above has a system defined method -> use it
        [self setBackgroundImage: [UIImage imageNamed: @"nav-bar"]
                   forBarMetrics: UIBarMetricsDefault];
    }
    else {
        //iOS4.0 requires us to override drawRect:. BUT!!
        //If you override drawRect: on iOS5.0 the system default will break,
        //so we dynamically add this method if required
        IMP implementation = class_getMethodImplementation([self class], @selector(iOS4drawRect:));
        class_addMethod([self class], @selector(drawRect:), implementation, "v@:{name=CGRect}");
    }
}

- (void)iOS4drawRect: (CGRect) rect {
    UIImage* bg = [UIImage imageNamed:@"nav-bar-blue"];
    [bg drawInRect: rect];
}

@end

Answer 6

It's not recommended to subclass the UINavigationBar class. The preferred way to customizing the navigation bar is to set it's properties to make it appear as you wish and use custom views inside UIBarButtonItems along with a delegate to get the desired behavior.

What are you trying to do that needs subclassing?

Also, I don't think IB is actually replacing the navigation bar. I'm pretty sure it's simply not displaying the default one and has your custom nav bar as a subview. If you call UINavigationController.navigationBar, do you get an instance of your bar?