iosobjective-ciphonecocoa-touchuitabbarcontroller

Change tab name in uitabbarcontroller


I have a TabBarController set as main controller tab, where names were defined using interface builder. Now I would like to change its names programmatically.

How could it be done?


Solution

  • Updated to XCode 15 (Swift UI)

    Been a while, all the history on this thread is still applicable, and the same logic applies to SwiftUI: It looks for the first view to set its tab bar item (same for navigation item), and all Views implement it:

    var body: some View {
        <Your View stuff>
        .tabItem({ Label(tab.title, systemImage: "house.fill" ) })
    }
    

    And since its composable, you can do it on the view you're defining, or directly on your tab bar.

    TabView() {
            MyView().tabItem({ Label(tab.title, systemImage: "house.fill") })
            OtherView().tabItem({ Label(tab.title, systemImage: "star.fill") })
        }
    

    Updated to XCode 8 (Storyboards)

    Since my original answer, a lot has happened: Swift 3, Storyboards, etc. Title is usually the one that all views share, and can be set in the attributes inspector

    Title Setup

    Also, for more control, you can always drag the UITabBarItem, and UINavigationItem elements from the designer view. You must drag them to the view that's gonna be displayed in the tab bar/navigation controller. Basically they store the info as "I wanna be displayed in tab bar like this".

    enter image description here

    Hello Scene is getting a TabBarItem added to it, so it can be configured.

    These two elements behave exactly as accessing the view controller's .tabBarItem and .navigationItem properties via code. These properties always exist in code if they are child of the corresponding object (nav has navItem, and tab has tabItem), you don't need to add them in storyboard/xib to have them.

    This last thing is kinda confusing, since in the storyboard/xib it appears you're adding them to the view controller, but in truth you're just saying "the nib will configure these properties too".

    Original Answer

    The name that appears on the tab bar comes from the UIViewController's title property,

    self.title = @"Name me!";
    

    You can change the title at any point, and it should update the text appearing on the tab bar item. But be wary, do this as soon as possible, ideally, in the init method in use (or initWithNibName:bundle:, or initWithCoder:).

    The key here, is that the init methods are called as soon as the tab bar appears on screen, as it initialises all of its view controller. If you were to do it on viewDidLoad, that would only get called if you actually select the tab, then other family of calls, same goes for awakeFromNib, viewWillAppear:, viewDidAppear:, etc.

    The idea of having a title on the UIViewController, is to keep things consistent. If you show that viewController on a UINavigationController, the navigation bar on top should use the title property, as it does when using back. The UITabBarController also respects the same title property and changes accordingly.

    In terms of reusability, you should be setting the title only from the inside of the UIViewController subclass.

    The way of the Nib

    Using nibs or storyboards? If you have a UIViewController, you can give it the name straight up in the attributes inspector (or 4)

    Using interface builder, in the Attributes Inspector

    Unfortunately, if the File Owner is the UIViewController subclass, then you won't be able to access it this way, simply because, XCode registers the File Owner as an "External Object", and doesn't show a configuration panel for it. :(

    Multiple titles, same view controller

    But sometimes, you just want to have them named differently

    // Modify the display title on the tab bar
    self.tabBarItem.title = @"World";
    
    // Modify the display title on the navigation bar
    self.navigationItem.title = @"Hello World";
    

    Screwing with the neighbours

    Each UIViewController should handle his own name, what if you want to force it from the outside (and thus, completely violating the original thing I said about reusability)?

    // Rename the other guy's .title property
    [[self.tabBarController.viewControllers objectAtIndex:<#Index#>] setTitle:@"Hello World"];
    
    // Or do as before, and rename the other guy's tab bar 
    [(UITabBarItem*)[self.tabBarController.tabBar.items objectAtIndex:<#index#>] setTitle:@"Hello World"];
    

    You could also probably do it with the navigation item, but that would require more gymnastics than I'm comfortable with.