본문 바로가기
프로그래밍/iOS

샘플코드와 그림으로 잘 정리한 UINavigationController Customization Tutorial

by 백룡화검 2012. 11. 7.

UINavigationController Customization Tutorial

In this tutorial I’ll go through various tasks that are usually performed with a navigation controller. Feel free to jump into a particular section if you’re looking for something specific, or leave a comment if you feel like something is missing.

Creating a UINavigationController programmatically

Creating a UINavigationController programmatically is trivial. Assuming that you’ve already created a class called RootViewController that subclasses UIViewController, you would use something like this, typically in your AppDelegate file:

  1. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {        
  2.   
  3.     // rootViewController can't be an instance of UITabBarController  
  4.     // remember to include RootViewController in your class!  
  5.     RootViewController * rootViewController = [[RootViewController alloc] initWithNibName:@"RootViewController" bundle:nil];  
  6.   
  7.     UINavigationController *navigationController = [[UINavigationController alloc] initWithRootViewController:rootViewController];  
  8.   
  9.     [self.window addSubview:navigationController.view];  
  10.   
  11.     // Don't bother releasing navigationController as it needs to be around all the time  
  12.   
  13.     [self.window makeKeyAndVisible];  
  14.   
  15.     return YES;  
  16. }  

Basically, we just create an instance of root controller and then we use it to create the navigation controller. Finally, we need to add the navigation controller’s view to the main window.

Adding a title to a navigation controller

Actually you don’t add a title directly to the navigation controller, instead you add it to the view controller that’s being displayed:

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5. }  

Hiding the Navigation Bar

Either in your view controller or where you initiated your navigation controller:

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5.     // hide the navigation bar  
  6.     // use setNavigationBarHidden:animated: if you need animation  
  7.     self.navigationController.navigationBarHidden = YES;  
  8. }  

Showing the navigation toolbar

Either in your view controller or where you initiated your navigation controller:

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5.     // hide the navigation bar  
  6.     // use setToolbarHidden:animated: if you need animation  
  7.     self.navigationController.toolbarHidden = NO;  
  8. }  

Changing the Navigation Bar background color

Either in your view controller or where you initiated your navigation controller:

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5.   
  6.     self.navigationController.navigationBar.tintColor = [UIColor   
  7.         colorWithRed:102.0/255   
  8.         green:52.0/255   
  9.         blue:133.0/255   
  10.         alpha:1];  
  11. }  

Changing the Navigation Bar style

Default style is UIBarStyleDefault, but you can use UIBarStyleBlack and eventually set the translucent propriety to YES.

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5.   
  6.     self.navigationController.navigationBar.barStyle = UIBarStyleBlack;  
  7. }  

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5.   
  6.     self.navigationController.navigationBar.barStyle = UIBarStyleBlack;  
  7.     self.navigationController.navigationBar.translucent = YES;  
  8. }  

Using a Navigation Bar background image

To use a background image for you navigation bar, you need to subclass UINavigationBar and declare your own drawRect method. You can add this code on its own file or at the top of your application delegate (after the import declarations):

  1. @implementation UINavigationBar (UINavigationBarCategory)  
  2.   
  3. - (void)drawRect:(CGRect)rect  
  4. {  
  5.     UIImage *image = [UIImage imageNamed:@"bg.png"];  
  6.   
  7.     [image drawInRect:rect];  
  8. }  
  9.   
  10. @end  

Changing Navigation Bar back button text

Here’s how to change the text of the back button:

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5.   
  6.     self.navigationController.navigationBar.backItem.title = @"Custom";  
  7. }  

Adding items to the right of your Navigation Bar

In your view controller:

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5.   
  6.     UIBarButtonItem *item = [[UIBarButtonItem alloc]   
  7.                              initWithBarButtonSystemItem:UIBarButtonSystemItemAdd   
  8.                              target:self   
  9.                              action:@selector(doSomething)];  
  10.     self.navigationItem.rightBarButtonItem = item;  
  11.   
  12.     [item release];  
  13. }  

Adding items to the Navigation Toolbar

To add items to your toolbar:

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5.   
  6.     // Show toolbar  
  7.     self.navigationController.toolbarHidden = NO;  
  8.   
  9.     UIBarButtonItem *item1 = [[UIBarButtonItem alloc]   
  10.                               initWithBarButtonSystemItem:UIBarButtonSystemItemAdd   
  11.                               target:self   
  12.                               action:nil];  
  13.   
  14.     UIBarButtonItem *item2 = [[UIBarButtonItem alloc]   
  15.                               initWithBarButtonSystemItem:UIBarButtonSystemItemEdit  
  16.                               target:self   
  17.                               action:nil];  
  18.   
  19.   
  20.     UIBarButtonItem *item3 = [[UIBarButtonItem alloc]   
  21.                               initWithBarButtonSystemItem:UIBarButtonSystemItemOrganize  
  22.                               target:self   
  23.                               action:nil];  
  24.   
  25.     NSArray *items = [NSArray arrayWithObjects:item1, item2, item3, nil];  
  26.   
  27.     self.toolbarItems = items;  
  28.   
  29.     [item1 release];  
  30.     [item2 release];  
  31.     [item3 release];  
  32. }  

Note that the items are not properly aligned. To align them, use flexible space:

  1. - (void)viewDidLoad {  
  2.     [super viewDidLoad];  
  3.   
  4.     self.title = @"My View Controller";  
  5.   
  6.     // Show toolbar  
  7.     self.navigationController.toolbarHidden = NO;  
  8.   
  9.     UIBarButtonItem *flexibleSpace = [[UIBarButtonItem alloc]   
  10.                                       initWithBarButtonSystemItem:UIBarButtonSystemItemFlexibleSpace   
  11.                                       target:nil   
  12.                                       action:nil];  
  13.   
  14.     UIBarButtonItem *item1 = [[UIBarButtonItem alloc]   
  15.                               initWithBarButtonSystemItem:UIBarButtonSystemItemAdd   
  16.                               target:self   
  17.                               action:nil];  
  18.   
  19.     UIBarButtonItem *item2 = [[UIBarButtonItem alloc]   
  20.                               initWithBarButtonSystemItem:UIBarButtonSystemItemEdit  
  21.                               target:self   
  22.                               action:nil];  
  23.   
  24.   
  25.     UIBarButtonItem *item3 = [[UIBarButtonItem alloc]   
  26.                               initWithBarButtonSystemItem:UIBarButtonSystemItemOrganize  
  27.                               target:self   
  28.                               action:nil];  
  29.   
  30.     NSArray *items = [NSArray arrayWithObjects:item1, flexibleSpace, item2, flexibleSpace, item3, nil];  
  31.   
  32.     self.toolbarItems = items;  
  33.   
  34.     [item1 release];  
  35.     [item2 release];  
  36.     [item3 release];  
  37. }