以编程方式在 UINavigationController 中设置 UINavigationBar 的自定义子类

有人知道如何使用我的自定义子类 UINavigationBar,如果我实例化 UINavigationController编程(没有 IB) ?

在 IB 中拖动一个 UINavigationController,在导航条下显示一个导航条,并使用身份检查,我可以改变类类型和设置自己的子类的 UINavigationBar,但编程我不能,navigationBar属性的导航控制器是只读..。

要以编程方式自定义导航栏,我应该做什么?IB 比“代码”更“强大”吗?我相信所有可以在 IB 中完成的工作都可以通过编程来完成。

49968 次浏览

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?

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.

I use "option 1"

Create a nib-file with only the UINavigationController in it. And set the UINavigationBar Class to my custom Class.

self.navigationController = [[[NSBundle mainBundle] loadNibNamed:@"navigationbar" owner:self options:nil] lastObject];


[navigationController pushViewController:rootViewController animated:YES];

Further to obb64's comment, I ended up using his trick with setViewControllers:animated: to set the controller as the rootController for the navigationController loaded from the nib. Here's the code I'm using:

- (void) presentModalViewControllerForClass: (Class) a_class {
UINavigationController *navController = [[[NSBundle mainBundle] loadNibNamed: @"CustomNavBar" owner:self options:nil] lastObject];


LoginSignupBaseViewController *controller = [[a_class alloc] initWithNibName: nil bundle: nil];
controller.navigationController = navController;
[navController setViewControllers: A(controller) animated: NO];


[self presentModalViewController: navController animated: YES];


[controller release];
}

As of iOS 4, you can use the UINib class to help solve this issue.

  1. Create your custom UINavigationBar subclass.
  2. Create an empty xib, add a UINavigationController as the single object.
  3. Set the class for the UINavigationController's UINavigationBar to your custom subclass.
  4. Set your root view controller via one of these methods:
    • [navController setViewcontrollers[NSArray arrayWithObject:myRootVC]];
    • [navController pushViewController:myRootVC];

In code:

UINib *nib = [UINib nibWithNibName:@"YourCustomXib" bundle:nil];
UINavigationController *navController =
[[nib instantiateWithOwner:nil options:nil] objectAtIndex:0];


Now you've got a UINavigationController with your custom UINavigationBar.

If you want to subclass navBar just to change background image - there is no need to in iOS 5. There will be method like this one setBackgroundImage

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
}

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;
}

One scenario I've found that we need to use subclass rather than category is to set navigationbar backgroundcolor with pattern image, because in iOS5 overwriting drawRect using category does not work any more. If you want to support ios3.1-5.0, the only way you can do is to subclass navigationbar.

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

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

Since iOS5, apple provides a method to do this directly. Reference

UINavigationController *navigationController= [[UINavigationController alloc]initWithNavigationBarClass:[CustomNavBar class] toolbarClass:nil];
[navigationController setViewControllers:[NSArray arrayWithObject:yourRootViewController]];

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