NEW: Master Swift design patterns with my latest book! >>

How to customize a view controller’s back button on a navigation bar: backBarButtonItem

Written by Paul Hudson    @twostraws

When you move between view controllers using UINavigationController, it automatically configures a Back button show either “Back” or the title of the previous view controller. That usually works well enough, but if your previous controller has a long title you’ll probably want something custom.

This is where the backBarButtonItem property comes in: set this to an instance of UIBarButtonItem to have UIKit create a back button title of your choosing. You don’t need to provide anything for the target or action parameters of your button, because even with a custom title it’s still just a back button.

Here’s some example code:

navigationItem.backBarButtonItem = UIBarButtonItem(title: "Cancel", style: .plain, target: nil, action: nil)

Available from iOS 2.0

Did this solution work for you? Please pass it on!

Other people are reading…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

Go from iOS to macOS the easy way!

If you like Hacking with Swift, you'll love Hacking with macOS – learn to build macOS apps today, using 18 real-world projects!

Click here to visit the Hacking with Swift store >>